# Why was my publish refused, and what do I do?

Checked 2026-11-15 against GilbApp d5296208bbffa2ab70076e6194f5537c4be1ddf7.

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](http://support.gilb.com/help/how-do-i-connect-my-computer-to-my-vault) 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 appsupport@gilb.com." Publish again under one of your own names, which does not use a new site, or write to support@gilb.com. 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?](http://support.gilb.com/help/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 support@gilb.com.

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?](http://support.gilb.com/help/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 "&lt;number of files\> files, &lt;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 support@gilb.com 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 support@gilb.com 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?
