Draft & Publish
The Draft & Publish feature allows to manage drafts for your content.
Plan: Free feature.
Role & permission: None.
Activation: Available but disabled by default.
Environment: Available in both Development & Production environment.
Configuration
For your content types to be managed with Draft & Publish in the Content Manager, the feature must be enabled through the Content-type Builder. Draft & Publish can be configured for each content type.
To enable Draft & Publish:
- Go to the
Content-type Builder via the main navigation of the admin panel. - Either edit the already created content type of your choice, or create a new content type.
- Go to the Advanced settings tab.
- Tick the Draft & Publish option.
Usage
The Draft & Publish feature is visible and used from the 
Content Manager, accessible via the main navigation of the admin panel. Edit any content type of your choice (with Draft & Publish enabled) to see and follow the documentation below.
With Draft & Publish enabled, your content can have 3 statuses:
| Status name | Description |
|---|---|
| Published | The content was previously published. There are no pending draft changes saved. |
| Modified | The content was previously published. You made some changes to the draft version and saved these changes, but the changes have not been published yet. |
| Draft | The content has never been published yet. |
In the Content Manager edit view (the view you see when editing an entry), the current status of an entry is indicated at the top of the interface, just below the entry title.
Working with drafts
While editing a document, you can see 2 tabs:
- The Draft tab is where you can edit your content.
- The Published tab is a read-only tab where edition of all fields is disabled. The Published tab only exists to show what is the content of fields in the published version.
By default, each newly created content is a draft. Drafts can be modified and saved at will, using the Save button in the Entry box on the right side of the interface, until they are ready to be published.
Once you made changes to a draft, you have 3 possible options, all available in the Entry box on the right side of the interface:
- Publish your document (see publishing a draft),
- Save your draft for later retrieval,
- or discard changes, by clicking on
and choosing 
Discard changes.
Publishing and unpublishing
While editing a document, you can decide to publish a draft or unpublish previously published content.
Publishing a draft
To publish a draft, click on the Publish button in the Entry box on the right side of the interface.
After a draft is published:
- The content of the Draft and Published tabs should be exactly the same (but the Published tab remains read-only).
- The status, below the document's title, will switch to "Published".
Before publishing a draft, make sure it doesn't have relations with other non-published content, otherwise some of the content may not be available through the API.
When a document has both a draft and a published version available, the published version can be found in the Published tab. If the document has only a draft version, you can not click on the Published tab.
To schedule publication, i.e., convert a draft to a published entry at a given date and time, you can include it in a release and schedule the publication of the release.
Unpublishing content
Previously published content can be unpublished.
To unpublish content, from the Draft tab, click on in the Entry box on the right side of the interface and choose the Unpublish button.
If the draft version of the document contains content different from the published version, you can decide what to do with both content when unpublishing:
- From the Draft tab, click on in the Entry box on the right side of the interface and choose the Unpublish button.
- In the Confirmation dialog that opens, you can choose to:
- Unpublish and keep last draft, so that all the content you currently have in the Draft tab is preserved, but the all the content from the Published tab is definitely gone
- Unpublish and replace last draft to discard any existing content in the Draft tab and replace it with the content of all fields from the Published tab
- Click Confirm. The desired changes will be applied to both the Draft and Published tabs and the new status of the entry will also be reflected below the entry title.
