← Back to Publishing failed or found a secret key. What now?
Why was my publish refused, and what do I do?
Short answer
Read the line the command printed: a word before a colon, such as site_limit_reached, names the fault; fix it and run the command again.
Deeper
When publishing is refused, the connector prints one line, mostly a word, a colon and a sentence, and nothing is put live. Its exit code says where it was refused: 2 on your computer, before anything is sent; 3 by GilbPlatform, when the command asks for its publish ticket, the short permission it gets first; 4 by the upload service that puts the files on pages.dev; 5 when the network failed. Each run asks for a new ticket, so after a fix run the same command again.
On your computer (exit 2). The name: The site name must be 3 to 40 characters., The site name may use only lowercase letters a to z, digits and hyphens. or The site name may not start or end with a hyphen, or contain two in a row. The folder: index.html is absent at the root, the folder has no files, the folder does not exist, refusing to follow the symlink and a path, or the number of files and bytes when there are more than 2000 files or 5 MB. Fix the name or the folder; a run with --dry-run shows these without sending anything.
Signing in (exit 2). This AI could not sign in to GilbPlatform., sometimes with a code in brackets, means the connector could not sign in as your AI: check that it is connected through ▸ CONNECT AI in GilbApp. With --as me you may see "This computer is not connected to GilbPlatform yet. Run: gilb-computer add — approve it once in GilbApp — then restart Claude Code." or This computer could not sign in to GilbPlatform. A mistyped option gives --dir is required., --name is required., --kind must be app or website., --as must be ai or me. or Unknown option: with the option.
site_name_refused: the name is kept back, because GilbPlatform uses it, such as admin or support, or because it is a well-known brand, such as paypal, or starts with one and a hyphen, such as paypal-login. Choose another name.
site_name_unavailable with is already taken. Choose another.: someone else holds that name; choose another. The same word with it cannot become a means you published that name before as the other kind, an app or a website: publish it again with the kind it has, or use a new name.
name_unavailable_at_host: That site name is not available on the hosting service. Choose another name. A name must be free on all of pages.dev, not only on GilbPlatform.
site_limit_reached: "You already have 2 sites, and your limit is 2. To be allowed more, write to [email protected]." Publish again under one of your own names, which does not use a new site, or write to [email protected]. A name reserved when a publish began but never published counts for 24 hours. The answer How many sites can I have, and how do I get more? tells more.
not_entitled: Publishing for this account was switched off, so it cannot publish. Write to [email protected].
app_cannot_publish: "An app cannot publish for its user. Publish from your own computer or your connector." The command was signed in with a person's sign-in that an app got for them. Publish with the connector's own sign-in, the default; never with an app's.
no_person: "A machine publishes only for the person it is bound to. This credential has no person behind it." The sign-in used is a program that acts for no person. Publish with the AI you connected through ▸ CONNECT AI, which acts for you, or with --as me.
too_many_tickets: "You have asked for 30 publish tickets in the last 10 minutes. Wait a few minutes and try again."
files_refused: the upload service read your files and refused one; the sentence names the file and why: a kind of file that is not taken, a file or folder named _headers, _redirects, _worker.js, _routes.json or functions, no index.html at the top, or looks like it contains a secret, such as a Stripe key or a private key block. Nothing was published. Remove what it names and publish again; the answer How do I publish my app from the terminal? lists what a folder may hold. Too many files or too many bytes is caught first on your computer: the connector prints "<number of files> files, <number of bytes> bytes; this ticket allows 2,000 files and 5,242,880 bytes" and sends nothing.
ticket_invalid, ticket_used or ticket_not_prechecked: the publish ticket ran out (it lasts 10 minutes) or was used already. claim_expired: the name you reserved was not published within 24 hours. In each case run the command again for a new ticket.
hosting_failed or hosting_capacity: write to [email protected] with the address and what the command printed.
The network (exit 5): the platform could not be reached, the upload could not reach the Worker or the upload timed out, after 2 minutes. Check your internet connection and run the command again.
If your AI ran the command for you, the line it printed is the one to read here. If the site does not open after it was published, write to [email protected] with the address and what the command printed.
This answer is written for a computer screen.
Source: Connector 0.6.1, served at https://gilb.com/app/gilb-connector.mjs, read 13 November 2026: :3697-3706 (the three name sentences), :3714-3790 (the folder does not exist, refusing to follow the symlink, the folder has no files, index.html is absent at the root), :3791-3796 (files and bytes over the limit), :3932-3942 (a refusal is printed as error: message), :4029-4037 (the upload service's refusal, the same way), :4049-4083, :3572 (the upload timed out after 120 seconds, the upload could not reach the Worker), :4270-4306 (exit codes 2, 3, 4, 5); the platform could not be reached in requestPublishTicket. GilbPlatform 0fc5a548 (https://id.gilb.com/version, read 13 November 2026): src/routes/publish.ts:132-135 (no_person), :146-149 (app_cannot_publish), :285-298 (the ticket refusals in order: app_cannot_publish, no_person, site_name_refused, not_entitled, too_many_tickets, the claim), :388-404 (claim_expired, site_limit_reached at the upload), :433, :458 (ticket_used, ticket_not_prechecked); src/publish/site-name.ts:16-36, :45-64 (reserved and brand names, is reserved. Choose another., uses a well-known brand name. Choose another.); src/publish/records.ts:134-135 (Publishing for this account was switched off, so it cannot publish.), :246 (24 hours), :256 (2 sites), :273-276 (the limit sentence), :378-420 (is already taken. Choose another., cannot become a, error site_name_unavailable when none is named in src/routes/publish.ts:298); src/publish/ticket.ts:19 (a ticket lasts 600 seconds); src/publish/ticket-rate.ts:7-8 (30 tickets in 10 minutes); workers/publish-ingest/src/index.ts:81 (ticket_invalid), :100 (files_refused), :124 (platform refusals passed on), :143-146 (name_unavailable_at_host, hosting_capacity, hosting_failed); workers/publish-ingest/src/checks.ts:125-160 (the file sentences: looks like it contains, Nothing was published.). Standards read from GilbPlatform on 13 November 2026: Proc_v_i_c_PublishPagesDev (step 9: read the refusal's code; not_entitled, app_cannot_publish, the site-limit message, a name already taken), Standard Rule_Code_deployment (RuleDeployPagesDev: the limit message; the name free across Cloudflare; never self-serve). Live help pages, sentences shared: How many sites can I have, and how do I get more?; How do I put my app or website live on the internet?
Checked against GilbApp d529620.