Publishing is how content moves from your private workspace to your live documentation site. Until a page is published, only your team can see it. Publishing mak...
Publishing is how content moves from your private workspace to your live documentation site. Until a page is published, only your team can see it. Publishing mak...
Publishing is how content moves from your private workspace to your live documentation site. Until a page is published, only your team can see it. Publishing makes it visible to readers (subject to your visibility settings) and refreshes your site within seconds.
Before you publish
A page is ready to publish when it's:
- Reviewed — if your project requires approval, the page must be approved first (see Review workflow).
- High quality — aim for an Excellent quality rating.
- Saved — autosave handles this; the top-bar badge reads Autosaved.
Publishing a single page
The publish control lives in the editor top bar. Its label depends on your governance Approval requirement: it reads Publish when no approval is required, or Submit for review when it is.
Click Preview to open the page as readers will see it.
Click Publish. If approval is required, click Submit for review instead — a reviewer approves it, and it goes live per your policy.
The page's status dot turns to Published.
Publishing a section or space
When several related pages are ready at once — a new feature touching a guide, an API reference, and a changelog entry — publish them together so readers never see a half-updated site:
- From a group's menu in the content tree, choose Publish section (or Submit section for review) — the label shows how many drafts are included.
- From a space's menu, choose Publish space to ship everything in the space.
- The top-bar split menu also offers Publish whole section while a page is open.
See Review workflow → Section and space batches.
Scheduled publishing
Coordinate a docs launch with a product release by scheduling. When publishing or approving, choose Schedule publish, pick a date and time, and the page publishes automatically at that moment. Scheduled pages stay in their current state with a scheduled time until they run.
Revising a published page
To edit a page that's already live, click Edit page in the top bar — it reverts the page to draft so you can work on it. Readers keep seeing the last published version until you publish your changes again, so live content is always safe to revise.
Unpublishing
To take a page offline without deleting it, unpublish it. The page is removed from the live site immediately, keeps its content and history, and can be republished at any time. Unpublishing is reversible — use it for content that's temporarily out of date or being reworked.
Publishing from the CLI
If you work docs-as-code, publish from your terminal with dxb push:
# Preview what would change
dxb diff
# Publish local changes to the live site
dxb pushThe CLI honors the same validation and approval rules as the app.