# Troubleshooting

Building with Glaze should be a seamless experience, but you may run into the occasional issue while creating an app. Start with the troubleshooting steps below to clear up the most common ones, and reach out to the team for further assistance if something still isn't right.

## Common Issues

### The agent is stuck or stopped responding

If the agent seems to have stalled mid-run, give it a moment first, since some steps (installing dependencies, building the app) take longer than others. If it's genuinely stuck, click the ** Stop button** in the composer to cancel the current run, then send your prompt again. A fresh attempt often gets past a one-off hiccup.

### A run finished but the app is blank or won't open

If your app opens to an empty window or doesn't appear at all, the run may have left it in a half-finished state. Go back to Agent Chat and tell the agent what you see, for example "the window is blank" or "the app didn't open". It can read what went wrong and fix it.

If a recent change is what broke things, you can step back. Every change the agent finishes is saved as a version, so you can **roll back** to the last one that worked and try again from there. See [Version History](/prompting/version-history).

### A request was too long or the run struggled with a large change

Very large requests are harder for the agent to handle in one pass. If a prompt is rejected for being too long, or a run struggles with a sprawling change, the fix is usually to break it up. Ask for the core of the app first, then add features one follow-up at a time. Smaller, focused prompts are also easier to get right. See [Writing Effective Prompts](/prompting/writing-effective-prompts).

### A connection or integration stopped working

If an app that talks to an outside service (like GitHub, Linear, or Slack) stops fetching data, the connection most likely needs to be re-authorized. Access can expire or be revoked on the service's side. Reconnect the integration, or provide new API keys, and the app should start fetching data again.

### An app won't install or update from the Store

Installing and updating requires you to be online, so check you're connected to an active internet connection first. If an install or update doesn't complete, try it again from the Store. If an app shows an **Update** but updating doesn't work, quitting and reopening Glaze usually clears it.

### The agent won't open with my keyboard shortcut

If your global **Agent Shortcut** doesn't open the agent, another app may already be using that key combination. Open **Settings** -> **General** and record a different shortcut.

## Try These First

Before reporting an issue, a few general steps clear up most one-off problems:

1. **Tell the agent what you see**: For anything about how an app looks or behaves, the agent is the fastest fix. Describe the problem in Agent Chat and let it repair the app in place.
2. **Roll back a bad change**: If a recent change broke something that used to work, return to an earlier version rather than trying to patch forward. See [Version History](/prompting/version-history).
3. **Restart Glaze**: Quitting and reopening Glaze clears up the occasional glitch, especially around installs, updates, and connections.
4. **Check your connection**: Building, installing, updating, and any feature that reaches an outside service need the internet. Finished apps run offline, but those steps don't.

## Still Need Help?

If an issue still persists, the Glaze team is happy to help. See [Contact Support](/contact-support) for all the ways to get in touch with us.