> For the complete documentation index, see [llms.txt](https://docs.morpht.com/convivial-for-govcms/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.morpht.com/convivial-for-govcms/content-editing/workflow.md).

# Workflow

Content moves through an editorial workflow. Nothing is visible to the public until an Approver publishes it, and a published page can have a newer draft alongside it — visitors keep seeing the published version until the draft is published in turn.

## States

| State            | Meaning                                              |
| ---------------- | ---------------------------------------------------- |
| **Draft**        | Work in progress. Visible only to logged-in editors. |
| **Needs review** | Ready for an Approver to check.                      |
| **Published**    | Live on the site.                                    |
| **Archived**     | Taken off the site but kept for reference.           |

## As an Author

When saving, choose under **Change to**:

* **Draft** — keep working.
* **Needs review** — hand over to an Approver. Add a **Revision log message** saying what changed and anything the reviewer should look at.

![Author workflow options](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-0d079bad82284237b7c5bbc6e78d4fe96cac09c9%2Fworkflow-author.png?alt=media)

## As an Approver

Approvers see the additional transitions:

* **Published** — from *Needs review*, make it live.
* **Draft** — from *Needs review*, send it back to the Author; say why in the revision log.
* **Archived** — take a published page off the site.
* **Restore** / **Restore to Draft** — bring an archived page back, live or as a draft.

![Approver workflow options](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-868093f5262c79a072d73194078ba8ceb413367b%2Fworkflow-approver.png?alt=media)

A user with both the Author and Approver roles can create and publish in one step. Site administrators additionally have **Fast publish** (draft straight to published) and **Republish** for use while a site is being built; on a live government site content should always pass through *Needs review*.

To find content waiting for review, go to *Manage → Content → Moderated content* or filter the content list by **Moderation state: Needs review**.

![Moderated content](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-36d37aee17217808d48894a650f7b3f64a72dd62%2Fmoderated-content.png?alt=media)
