Publish and update
Make your project live, publish updates, and recover from publication errors.
Publishing makes the selected editor state available at your website's public address. You need an Owner, Admin, or Editor role in the workspace.
Publish the first time or update your site
Check saved drafts before publishing
Publishing clears draft entries, even if publication later fails. If Newer drafts will be lost appears, only continue when you no longer need those drafts.
- Open your project in the editor and check that it contains the state you want visitors to see. To test the page, turn off Design mode in the canvas toolbar.
- Select Publish in the editor header.
- Check the version shown in the Current → Will become cards. If Older version selected appears, make sure publishing that older state is intentional.
- Select Make it live.
- Wait for publication to finish. Reopen Publish and look for Up to date and Version N is live.
- Select View live site and check the result at the public address.
Current unversioned file changes are included when you publish. You do not have to create a version manually first.
For a pending settings update on an already live version, the action can be Publish changes. That applies the update while keeping the same major version number.
To use your own address after publishing, follow Connect a custom domain.
Check progress and publication history
While publication is running, the header shows Publishing…. Open it to check progress.
To inspect previous attempts:
- Select the project name in the editor header.
- Open Settings.
- Select Publishing.
- Check Deployment history for Queued, Building, Deploying, Deployed, or Failed attempts. Use Live URL to inspect the website itself.
If publication fails
Open Publish in the editor header to view Couldn't publish. The available actions depend on the error:
| Action | When to use it |
|---|---|
| Show details | Read the error and logs. |
| Ask AI | Ask the agent to investigate the error. Review its changes before publishing again. |
| Try again | Retry after resolving the problem or a temporary failure. |
Try again publishes the state currently loaded in the editor. If you edited or switched versions after the failure, check your current state before retrying.
During a pending or failed update, check the last successful publication at Live URL. If the first publication failed, there may not be a live site yet.
Cancel a running publication
Open Publish while the job is running and select Cancel. Wait for the result before starting another publication.
After an interruption, inspect Live URL and the version marked Live before retrying. Publication may have completed by the time a cancellation was processed.