Publishing your app
Give your project a public URL on a layout-app.com subdomain.
Publishing turns your project into a live site at <subdomain>.layout-app.com. This guide walks through the first publish, updating a published app, and the options you have along the way.
Prerequisites
- A project that builds successfully (you can see the preview)
- A subdomain in mind — lowercase letters, numbers, and hyphens
Steps
Open the publish panel
Click Publish in the top-right of the workspace.
Pick a subdomain
Type the subdomain you want. Layout checks availability as you type. Your app will live at <subdomain>.layout-app.com.
my-todo → https://my-todo.layout-app.comConfirm
Click Publish. Layout packages the current version and deploys it. First publishes take 10–20 seconds.
Verify
Open the published URL in a new tab. You should see the same app as your preview, served from the public subdomain.
Update a published app
Every new build updates your preview, not the published site. To push changes live:
- Make your changes as usual in chat
- Open the publish panel again
- Click Publish
The published site flips to the new version when the deploy finishes. Until then, visitors keep seeing the previous version.
You control when to publish. Experiment freely in the editor — nothing goes live until you press Publish again.
Publish a reverted version
If you reverted to an older version after publishing, the publish panel reflects which version is currently live and which you are about to push.
- The status header reads Published · Version N when the live site is out of sync with what you are previewing
- The publish button reads Publish current version when you are on a reverted version, and Publish latest version when you are back on the head of the project
This lets you roll the published site back to an older build without losing newer versions from your history — useful when a recent change broke something live and you want the URL to serve a known-good build while you fix forward.
Change the subdomain
Open the publish panel and edit the subdomain field. Saving moves the site to the new URL. The old subdomain is released.
Hide the Layout badge
Published apps include a small "Built with Layout" badge that links back to Layout. The badge is visible by default on every published page.
To hide it, flip the Hide Layout badge switch in the publish panel. The change takes effect on the next publish.
Hiding the badge is a Pro feature. On the free plan, the switch appears greyed out next to a Pro tag, and hovering it shows an upgrade link. Upgrade from Billing to enable the toggle.
Unpublish
Open the publish panel and click Unpublish. The subdomain stops serving and becomes available again. Your project and its history are untouched.