Publish requests
Ask teammates to review your changes before they go live, then approve, close, reopen or publish the request.
When to use a publish request
A publish request bundles changes to one or more topics so others can check them before readers see them. It shows what changed in each topic, collects approvals and comments, and publishes everything in one go.
- Without an approval process, publish requests are optional. Use one when you want a second pair of eyes. You pick the reviewers.
- With an approval process, every change goes through a publish request. The process adds its approvers as reviewers and decides when the request can be published. See Set up approval processes.
Create a publish request
- Open a topic you changed.
- Open the request form:
- If the document has an approval process, select Publish Request.
- Otherwise, select the arrow next to Publish, then Publish Request.
- On the Overview tab, enter a Title and a Description of what changed and why.
- Under Reviewers, add the teammates who should review. With an approval process, its approvers are already there.
- Open the Changes tab and check every topic you want in the request. Select a topic to see its changes.
- Select Create.

Reviewers get a notification asking them to review.
Review a request
If you're a reviewer, open the request from your notification or from the document's Publish Requests page.
- Read the Overview, then open Changes. The tab shows counts of new, modified and deleted topics. Select a topic to compare its new version with what's live.
- Leave comments on the request in Overview, or on a single topic in Changes.
- Choose your verdict at the top right:
- Approve: you're happy with the changes. Select it again (Disapprove) to take your approval back.
- Needs work: the request shouldn't be published yet. Select it again to withdraw it.

Publish the request
When the request can't be published yet, a warning icon (Uncompleted task(s)) lists what's missing, such as a rule in a step that hasn't passed or a reviewer who hasn't approved.
When every reviewer has approved and every rule has passed, Publish becomes available.
- Select Publish.
- Wait for “Publish was successful”. The changes are live, and the request moves to Published.
Anyone with the Writer, Admin or Owner role can select Publish. Watchers get a notification when the request is ready and when it's published.
Edit, close or reopen a request
- Edit: select Edit, change the title, description, reviewers or topics, and select Save. Reviewers added by the approval process can't be removed.
- Close: select the arrow next to Publish, then Close. A closed request keeps its history but can't be published.
- Reopen: open the closed request and select Publish. The request goes back to Open, and you can publish it once it passes its rules again.
Find publish requests
- Open the document and select Publish Requests in the sidebar.
- Switch between Open, Published, Closed and All.
- Type in Filter by title ... to find a request by name.
If something goes wrong
“Choose at least one topic in the changes tab.”
Open Changes and check at least one topic before you select Create or Save.
“Reviewers assigned in the approval process can not be removed.”
The approval process added this reviewer. To change who approves, an Owner edits the process.
Publish stays disabled
Open Uncompleted task(s) to see what's missing. Every reviewer on the request has to approve, including reviewers you added yourself.