Publishing & Domains

Ready to go live? Press the publish button.

To go live you just press the publish button. When you do your pages are rendered and uploaded to Cloudflare's global CDN. Small sites take less than a minute to publish. Larger sites may take a couple.

Geppetto gives you two places to publish: a Preview Site and a Live Site. The preview is hidden from search engines. Use it to check your site before sharing it with the world.

Domain

Every site gets these two domains.

Live URL: yoursite.gpto.site
Preview URL: preview-yoursite.gpto.site

Custom Domain

If you have a paid plan you can connect your own domain in Settings → Custom domain. Geppetto handles the SSL certificate for you.

Enter your domain (e.g. www.yourdomain.com).
Add the DNS records Geppetto shows you. It gives you the exact records to create at your registrar: a TXT record to verify you own the domain and a CNAME to route traffic. Pick your registrar (GoDaddy, Namecheap, Cloudflare, Squarespace, …) from the dropdown and the records are formatted for it, with a tip on where to paste them.
Click Verify. Geppetto checks the records, provisions the domain, and issues a certificate. This usually takes a few minutes; certificates can lag a little, so if it's still "issuing," wait and verify again.

DNS changes take 5–60 minutes to propagate (sometimes a few hours on slower registrars).

Publish Requests

If you're on the Team plan you can use the Publish Request feature to deploy only specific pages. This workflow also allows contributors or other users to submit requests to publish changes.

A common workflow would be:

Contributor edits page
Contributor submits publish request
Publisher role or higher publishes request

Download Your Site

Click Download site as ZIP to get an archive of your entire static site. Unzip it, drop it on any static host (Netlify, Vercel, your own server), and it works.

No lock-in. It's just HTML, CSS, and JavaScript. Runs anywhere. Want to leave Geppetto? Download your site, host it elsewhere, edit it directly. You made it. It's yours.

Performance

Your site is fast by default. Set your image field sizes and compression settings. Keep blocks per page reasonable (5–10, not 50). Avoid huge external scripts. No giant videos.

But honestly? Don't obsess. Static sites are fast by nature. Global delivery does the work.

Troubleshooting

Deploy button disabled: You need Developer or Owner role (check Settings → Users).

Site looks wrong: Did you save before deploying? Check preview first. If preview is broken, fix templates. If preview is fine, deploy again.

Custom domain not working: DNS takes 5–60 minutes. Double-check the records against the values in Settings → Custom domain, then click Verify again. On Cloudflare, make sure the record is DNS only (gray cloud), not proxied.

Old content showing: Clear browser cache (Cmd+Shift+R). Global cache refreshes in minutes. Try incognito to confirm.