// troubleshooting guide · raycast
Raycast Extension Not Working or Erroring
- Status
- Workaround available
- platforms:
- macOS, Windows
- updated:
- November 15, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · raycast/extension-not-working3 FIXES
// quick answer
Re-run the command, update the extension in the Store, and report it with name and version if it still fails.
Most likely fix: Retry
How to fix it
// try these in order, the most common fix is first
FIX 1Retry
- 01Run the command again
Did this fix it?FIX 2Update
- 01Open Search Store
- 02Update the extension
Did this fix it?FIX 3Local development
- 01Update @raycast/api in package.json
- 02npm install then npm run dev
Did this fix it?
Symptoms
Extension shows an error or blank view.
Why it happens
- C-01Transient network or API error
- C-02Outdated extension
- C-03Extension broken by API changes
// this guide also covers
- raycast extension not working
- raycast extension error
Still not working?
If Raycast keeps failing, you're not alone. See every Raycast problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to us