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

# Troubleshooting

> Find the message you are seeing and what to do about it.

Find what you are seeing in the first column. Messages are quoted as the app shows them.

## Generating

| What you see | What it means | What to do |
| - | - | - |
| "Your organization is out of credits. Upgrade your plan to keep generating." | The organization's balance is at zero | An admin can upgrade or buy a credit pack. See [When you run low or run out](https://docs.polymet.ai/plans/out-of-credits.md) |
| "You've used today's free credits. They reset tomorrow — upgrade or buy credits to keep generating now." | The day's 250 free credits are used and there are no paid credits | Wait until 00:00 UTC, or upgrade. See [How credits work](https://docs.polymet.ai/plans/credits.md) |
| "Not enough credits to queue your message" | Queued messages need credits too | Same as above |
| "There are pending edits. Send them to the agent before editing the code." | You made notes with **Select** that have not been sent | Send them from the generation input, or remove them. See [Select and edit with AI](https://docs.polymet.ai/canvas/select-and-edit.md) |
| "You can only edit the latest version" | You are viewing an earlier version | Go back to the latest version, or roll back. See [Versions and rollback](https://docs.polymet.ai/team/versions.md) |
| A model in the menu shows **Paid plans** | That model needs a paid plan | Pick another model, or upgrade. See [Models and thinking effort](https://docs.polymet.ai/canvas/models.md) |

## Publishing and domains

| What you see | What it means | What to do |
| - | - | - |
| "Only main can be published" (with your default branch's name) | You are on a branch. Only the default branch publishes | Click **Switch to main**, or merge your branch first. See [Branches](https://docs.polymet.ai/team/branches.md) |
| "There are no prototypes yet" | A prototype is what gets published, and the project has none | Click **Create a prototype**. See [Publish a prototype](https://docs.polymet.ai/publish/publish.md) |
| "There are new updates since the last publish" | Your live link shows an older version | Click **Update** |
| A custom domain shows **Pending**, **Verification Failed** or **Misconfigured** | The DNS records are missing or wrong | Check the records and click **Refresh**. DNS changes can take up to 48 hours. See [Use your own domain](https://docs.polymet.ai/publish/custom-domains.md) |
| "Custom domains require a paid plan — upgrade to connect your own domain" | Custom domains are not on the Free plan | See [Plans](https://docs.polymet.ai/plans/plans.md) |
| "Code export requires a paid plan — upgrade to export your app" | Code export is not on the Free plan | See [Export your code](https://docs.polymet.ai/publish/export-code.md) |

## GitHub

| What you see | What it means | What to do |
| - | - | - |
| "GitHub Connection Lost" | Polymet's access to your GitHub account was revoked, or the app was removed | Click **Reconnect GitHub** or **Open GitHub Settings**. See [Connect GitHub](https://docs.polymet.ai/github/connect.md) |
| "Saved in Polymet" after a change | GitHub refused the push; your change is kept in Polymet | Remove the secret or large file GitHub is refusing. See [Sync a project with a repository](https://docs.polymet.ai/github/sync.md) |
| "Exporting to GitHub requires a paid plan — upgrade to link this project" | Linking a project to a new repository is a code export | See [Plans](https://docs.polymet.ai/plans/plans.md). Importing an existing repository works on every plan |

## Design systems

| What you see | What it means | What to do |
| - | - | - |
| "No released design systems found" | No design system in your organization has a release yet | See [Release a design system](https://docs.polymet.ai/design-systems/release.md) |
| "Only main can be released" (with your default branch's name) | Releases come from the default branch | Merge your branch, switch, then release |
| **Unlink** is disabled: "This design system is used in 3 components. Remove these dependencies before unlinking." | Files in the project still use the design system | Open **Usages**, change those files, then unlink. See [Use a design system in a project](https://docs.polymet.ai/design-systems/use.md) |
| "Cannot rollback - a newer version has been released" | A design system cannot go back past a released version | Make the change as a new version instead |

## Backend

| What you see | What it means | What to do |
| - | - | - |
| "Backend setup failed" | Setting up the backend did not finish | Refresh and try again, or click **Contact support**. See [Add a backend](https://docs.polymet.ai/backend/overview.md) |
| "Couldn't load backend integration" | The Backend view could not load | Click **Retry** |
| "Migrations not deployed — runs on main only" (with your default branch's name) | Every branch shares one backend, so live changes run only on the default branch | Merge, switch to the default branch and ask the agent to apply them. See [Manage your data](https://docs.polymet.ai/backend/manage.md) |

## Billing

| What you see | What it means | What to do |
| - | - | - |
| "Only organization admins can manage billing" | You are a member, not an admin | Ask an admin. See [Invite your team](https://docs.polymet.ai/team/members.md) |
| "Payment failed, update payment method to continue using Polymet" | A payment did not go through. Your plan keeps working while it is retried | An admin clicks **Update payment method**. See [Invoices and failed payments](https://docs.polymet.ai/plans/billing.md) |
| "Billing settings become available after your first purchase." | The organization has never paid for anything | Nothing to do until you buy a plan |

## Still stuck

Click the **?** in the bottom-right corner of the app to chat with us, or email [support@polymet.ai](mailto:support@polymet.ai). Tell us what you were doing and the exact message you saw.


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