Troubleshooting

If something isn't working as expected in Raycast, this page walks you through the steps you can take yourself, the diagnostic information that helps us pin down what's going wrong, and how to send it to the team.

The steps below cover Raycast for Mac, Windows, and iOS. Where the platforms differ, you'll see specific instructions for each. Working through this list before reaching out usually shortens the back-and-forth and gets you to a fix faster.

Try these first

Most Raycast issues fall into a handful of common patterns. Before sending a report, run through these quick checks. They take a few minutes and resolve a large share of issues on their own.

Common situations

If the first-aid steps didn't help, see whether your issue matches one of the patterns below. Each one expands with steps specific to that situation.

Information to gather before reporting

When you do reach out, the more concrete information you can include, the faster we can reproduce and fix the issue. Most reports benefit from including each of the items below.

Once you've gathered the information above, send it to us using the Send Feedback command inside Raycast (Mac and Windows) or the Share Feedback option inside the iOS app, or use one of the other channels listed on the Contact Support page.