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 |
| ”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 |
| ”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 |
| ”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 |
| A model in the menu shows Paid plans | That model needs a paid plan | Pick another model, or upgrade. See Models and thinking effort |
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 |
| ”There are no prototypes yet” | A prototype is what gets published, and the project has none | Click Create a prototype. See Publish a prototype |
| ”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 |
| ”Custom domains require a paid plan — upgrade to connect your own domain” | Custom domains are not on the Free plan | See Plans |
| ”Code export requires a paid plan — upgrade to export your app” | Code export is not on the Free plan | See Export your code |
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 |
| ”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 |
| ”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. 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 |
| ”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 |
| ”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 |
| ”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 |
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 |
| ”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 |
| ”Billing settings become available after your first purchase.” | The organization has never paid for anything | Nothing to do until you buy a plan |