> ## Documentation Index
> Fetch the complete documentation index at: https://wonder.design/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Find the fix for a problem in Wonder by what you see: a chat that stopped, a Preview that won't start, an agent that can't reach Wonder, an import that failed or a payment problem.

Find what you're seeing below and follow the link to its fix. Most pages end with an **If something goes wrong** section for the problems of that feature. If Wonder shows a message, you can also look it up in [Error messages](https://wonder.design/docs/error-messages.md).

**Before you start** · Web and desktop · Free plan

## Opening Wonder

* **The desktop app didn't open, or an update won't install.** See [Desktop app and browser](https://wonder.design/docs/desktop-app-and-browser.md#if-something-goes-wrong).
* **Wonder asks you to install Node.js, or the tour doesn't continue.** See [Quickstart](https://wonder.design/docs/quickstart.md#if-something-goes-wrong).
* **You can't find chats, repositories or the Preview.** They're in the desktop app. See [What is Wonder](https://wonder.design/docs/what-is-wonder.md#if-something-goes-wrong).
* **You can't sign in, or the sign-in link expired.** See [Your account](https://wonder.design/docs/your-account.md#if-something-goes-wrong).

## Chats and agents

* **A chat stopped, won't send, or asks you to sign in to Claude or Codex.** See [Fix a stopped chat](https://wonder.design/docs/fix-a-stopped-chat.md).
* **A file, image or Figma design wasn't attached.** See [Give your agent context](https://wonder.design/docs/give-your-agent-context.md#if-something-goes-wrong).
* **You can't find a chat, or can't go back to an earlier message.** See [Manage your chats](https://wonder.design/docs/manage-your-chats.md#if-something-goes-wrong).
* **The chat can't open a folder or file you gave it.** See [Choose what a chat works with](https://wonder.design/docs/choose-what-a-chat-works-with.md#if-something-goes-wrong).
* **A selection from the canvas won't add to the chat.** See [Add to chat from the canvas](https://wonder.design/docs/add-to-chat-from-the-canvas.md#if-something-goes-wrong).
* **The chat asks for approval when you didn't expect it, or a mode is greyed out.** See [Permission modes and approvals](https://wonder.design/docs/permission-modes-and-approvals.md#if-something-goes-wrong).
* **A model isn't available, or a review won't start.** See [Choose models and reviewers](https://wonder.design/docs/choose-models-and-reviewers.md#if-something-goes-wrong).
* **A tool or MCP server is missing or won't connect in a chat.** See [Tools and MCP servers](https://wonder.design/docs/tools-and-mcp-servers.md#if-something-goes-wrong).
* **An agent doesn't remember your preferences.** See [Memory and design preferences](https://wonder.design/docs/memory-and-design-preferences.md#if-something-goes-wrong).
* **A chat setting doesn't take effect.** See [Agent and chat preferences](https://wonder.design/docs/agent-and-chat-preferences.md#if-something-goes-wrong).
* **The agent changed a copy instead of your design, or stopped adding layers.** See [Design with AI](https://wonder.design/docs/design-with-ai.md#if-something-goes-wrong).
* **Images or vectors won't generate.** See [Generate images and vectors](https://wonder.design/docs/generate-images-and-vectors.md#if-something-goes-wrong).

## Work with your code

* **A change, file or terminal doesn't show, or won't open.** See [Files, changes and terminal](https://wonder.design/docs/files-changes-and-terminal.md#if-something-goes-wrong).
* **A push or pull request fails.** See [Commit, push and pull requests](https://wonder.design/docs/commit-push-and-pull-requests.md#if-something-goes-wrong).
* **The app doesn't match the design you applied, or your agent can't read it.** See [Apply a design to your code](https://wonder.design/docs/apply-a-design-to-your-code.md#if-something-goes-wrong).

## Preview and publish

* **The Preview shows a card instead of your app.** See [Fix Preview problems](https://wonder.design/docs/fix-preview-problems.md).
* **Your app can't sign in inside the Preview.** See [Preview sign-in](https://wonder.design/docs/preview-sign-in.md).
* **Your app starts in your terminal but not in the Preview.** See [Set up the Preview](https://wonder.design/docs/set-up-the-preview.md#if-something-goes-wrong).
* **You can't start a Preview.** See [Preview your running app](https://wonder.design/docs/preview-your-running-app.md#if-something-goes-wrong).
* **Inspect is greyed out, or an element won't add to the chat.** See [Inspect your running app](https://wonder.design/docs/inspect-your-running-app.md#if-something-goes-wrong).
* **Capture is greyed out, or parts of the page are missing on the canvas.** See [Capture your running app](https://wonder.design/docs/capture-your-running-app.md#if-something-goes-wrong).
* **Your site wasn't published.** See [Publish your app](https://wonder.design/docs/publish-your-app.md#if-something-goes-wrong).

## Wonder MCP

* **Wonder doesn't show up in your agent, won't connect, or keeps asking you to sign in.** See [Wonder MCP troubleshooting](https://wonder.design/docs/wonder-mcp-troubleshooting.md).
* **The agent can read but not edit, or reached a limit.** See [Wonder MCP troubleshooting](https://wonder.design/docs/wonder-mcp-troubleshooting.md) and [Limits on each call](https://wonder.design/docs/wonder-mcp-tools.md#limits-on-each-call).

## Importing

* **Images from Figma are missing, or Figma is limiting requests.** See [Import from Figma](https://wonder.design/docs/import-from-figma.md#if-something-goes-wrong).
* **Wonder Capture does nothing, or the capture is too large.** See [Wonder Capture](https://wonder.design/docs/wonder-capture.md#if-something-goes-wrong).
* **Figma won't connect, or Linear isn't listed.** See [Connections](https://wonder.design/docs/connections.md#if-something-goes-wrong).
* **Moving your work from Conductor didn't finish.** See [Move from Conductor](https://wonder.design/docs/migrate-from-conductor.md#if-something-goes-wrong), or [Move from Conductor by hand](https://wonder.design/docs/migrate-from-conductor-by-hand#if-something-goes-wrong) if you copied it yourself.

## Design on the canvas

* **A variable or icon can't be added, renamed or bound.** See [Variables](https://wonder.design/docs/variables.md#if-something-goes-wrong) and [Icons](https://wonder.design/docs/icons.md#if-something-goes-wrong).
* **A shader won't load or move.** See [Shaders](https://wonder.design/docs/shaders.md#if-something-goes-wrong).

## Workspaces and sharing

* **You can't edit a file in a team workspace.** See [Workspaces](https://wonder.design/docs/workspaces.md#if-something-goes-wrong) and [Members and roles](https://wonder.design/docs/members-and-roles.md#if-something-goes-wrong).
* **You can't create, find or move a file.** See [Files and folders](https://wonder.design/docs/files-and-folders.md#if-something-goes-wrong) and [Move a file to another workspace](https://wonder.design/docs/move-a-file-to-another-workspace.md#if-something-goes-wrong).
* **A link opens the wrong place, or Share is missing.** See [Share a file](https://wonder.design/docs/share-a-file.md#if-something-goes-wrong).
* **You can't see other people's cursors.** See [Work together in real time](https://wonder.design/docs/work-together-in-real-time.md#if-something-goes-wrong).

## Account and billing

* **You reached the Free plan's weekly AI layers, or image generation needs a paid plan.** See [Plans and limits](https://wonder.design/docs/plans-and-limits.md#if-something-goes-wrong).
* **A payment failed, or your plan is inactive.** See [Manage your subscription](https://wonder.design/docs/manage-your-subscription.md#if-something-goes-wrong).
* **A sign-in method or username won't save.** See [Your account](https://wonder.design/docs/your-account.md#if-something-goes-wrong).

## If something goes wrong

If nothing here matches, ask your chat in Wonder or contact us. See [Support](https://wonder.design/docs/support.md).

## Related

* [Error messages](https://wonder.design/docs/error-messages.md)
* [Keyboard shortcuts](https://wonder.design/docs/keyboard-shortcuts.md)
* [Support](https://wonder.design/docs/support.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.