Troubleshooting
When a publish fails, the dashboard shows a message and, where it helps, a prompt to paste back into Claude. Each error also has a short code; here is what each one means. If many things fail at once, check the status page.
not_static- The upload looks like an app with a server (API routes, a Node server, PHP), not a static site.
- Ask Claude for a static export and upload the built folder.
Export this as a static site I can upload: one folder with `index.html` at the top (or in `dist/` / `out/`), no API routes, no server. If it is a Next.js app, use a static export.
missing_index- There is no `index.html` at the top of the upload or in `dist/` or `out/`.
- Upload the built site, not the project source, or paste a single `index.html`.
Build a static site and zip the `dist` or `out` folder so `index.html` is inside. Don’t include `node_modules`.
empty- Nothing was pasted or dropped, or every file was ignored.
- Paste your `index.html`, or drop the file, folder or zip.
size_limit- The upload is over your plan’s size, file count or per-file limit.
- Make the site smaller (see Limits), or upgrade for higher limits.
Make this site smaller so it fits a small static host: compress or resize the images, remove unused files, fonts and source maps, and give me one folder with `index.html` at the top.
bad_zip- The zip could not be opened.
- Zip the folder again with your system’s built-in compress option.
nested_zip- The zip contains another zip.
- Unzip the inner zip and include its files directly.
zip_slip- The archive has unsafe paths (`..`, absolute or Windows-style paths).
- Zip the site folder itself rather than a path on your drive.
bad_slug- The link name is not allowed: wrong characters, too long, or reserved.
- Use 1 to 32 lowercase letters, digits and dashes, not starting or ending with a dash.
slug_taken- Someone else has that link name, or released it less than 30 days ago.
- Pick another name.
site_limit- You already have as many sites as your plan allows. Paused and unavailable sites count too.
- Replace an existing site, delete one, or upgrade.
rate_limited- You published about 20 times in the last hour.
- Wait a little and try again.
content_blocked- The publish-time scan found a sign-in or payment page imitating another company, or similar.
- Remove that content. If you think this is a mistake, write to the abuse address in the message.
terms_required- The Terms of Service changed and you have not accepted the new version yet.
- Open the dashboard and accept the updated terms.
account_disabled- The account was disabled for breaking the Acceptable Use Policy.
- You can still delete your sites. Write to the abuse address if you think it was a mistake.
not_found- The site does not exist or is not yours.
- Check the link name in your sites list.
bad_upload- A file in a large upload was not a type MicroHost serves, or the upload list was malformed.
- Upload only the site’s files (see Limits for the allowed types) and try again.
forbidden_upload- The upload referred to files from another account.
- Upload the files again from your own browser session.
upload_missing- An uploaded file expired or went missing before the publish finished.
- Upload again.
uploads_not_configured- Large uploads are unavailable on this server.
- Keep the upload under 4.5 MB, or paste a single file.
hosting_not_configured- Publishing is not set up on this server.
- Nothing you can do; check the status page and try later.
hosting_missing- The hosting for this site was removed outside MicroHost.
- Delete the site and publish it again.
vercel_not_found- The hosting provider could not find something it was asked about.
- Try again. If it keeps happening, delete the site and publish it again.
vercel_error- The hosting provider returned an error.
- Try again in a minute, and check the status page.
deploy_failed- The new version did not go live. The previous version keeps serving.
- Try again. If it fails twice, check the status page.
deploy_timeout- The new version is taking longer than usual.
- Refresh in a minute; it may still go live.