Draft & Reviews System

the review system gives teams control over documentation quality through a dedicated reviewer role, ensuring all changes are approved before being published overview the review system is an editing mode for writing and managing documentation when enabled, all document changes go through a structured draft and approval flow instead of being applied directly an administrator can enable or disable it per space from space settings → general > choose edit mode when creating a new space, you can choose which editing mode suits it best — use the review & draft system for spaces that require content approval, or keep free edit mode for faster, unrestricted editing this can be changed at any time from the space settings key behaviors at a glance only one draft can exist per document at any given time drafts are visible and editable by all users, but only reviewers can merge or discard them when a space is published, only the main version of a document is published — never the draft this lets you enforce a review process for public facing portals while keeping internal team spaces unrestricted for faster edits how to enable the draft & reviews system open your space dashboard navigate to space settings → general under the edit mode section, select your preferred editing mode edit, review, and merge documents once the review system is enabled, the editing flow of a document will change you will now have to create a draft for each doc you want to modify a document can only have one draft active and will be available for everyone to see and edit go to any document and enter draft mode by clicking the edit draft button from the doc options bar a draft is created, and now you can start editing the doc you can see above the doc title that you have 2 versions of the current doc original and draft every time you navigate to a doc, you will see the orginal version if you want to edit, manually switch to the draft version while editing a draft, click the review button on the right side of the doc options bar to view diff request review review & merge view diff this option will open a new window where you can see all the changes made to the draft compared to the original request review this option will send a notification to the users with review permissions on this space use this when you completed your work and you need validation from a reviewer if you are a reviewer and receive this notification, just click on it and it will take you to the mentioned doc review & merge this option is only available to users with review permissions if you are a reviewer and want to review & merge or discard a draft, click on this option, and a new window will open with a diff view of the changes and 2 buttons discard draft and merge draft clicking on discard will delete the draft and return to original version clicking on merge the draft will replace the original version review and publish while review system is enabled for a space, a new step is added before you publish the publish button is now replaced with review & publish review & publish is a new window that will allow you to review all changes made since the last publish of the space here's how it works documents here, you will see a list of newly added docs and removed docs this menu is purely informative, and you can not make any actions here about the documents drafts this menu shows all docs that have a draft active if you have review permissions, you can merge the drafts directly from this menu and then publish the space space settings analyse changes made to space settings navigate to your published content