Docs

File requirements

Exactly what a site needs to go live on Just Publish. In short: an index.html at the top level, relative paths, and static files within the size limits.

What a publishable site needs

Just Publish hosts static websites - plain files a browser can open directly, with no server running your code. A site is publishable when it meets all of the requirements below.

Size limits

These are the enforced caps at publish time:

A site on Builder holds more: up to 200 MB, 1,000 files and 10 MB per file. One upload carries up to 16 MB, so a bigger site goes in parts: Update in My websites splits it for you, and an assistant publishes the first part with deploy and adds the rest with update_site_file. A new site starts on Free, so its first publish fits the Free limits.

A site on Builder can also have its own 404 page: put a 404.html at the top level and visitors see it, with status 404, on any address the site does not have.

If a site exceeds a limit, the deploy is rejected with a message explaining which limit and how to fix it - see the error reference.

Accepted inputs

The same requirements apply however you publish: a ZIP, a folder, individual files, or pasted HTML. What matters is the result - an index.html at the top level, relative paths, and static files within the limits above.

For AI agents

This part is written for AI assistants and agents - you can skip it.

Related