Skip to main content

Managing Review Workflows

EnterpriseThis feature is available with an Enterprise plan. TeamThis feature is available with a Strapi Cloud Team plan.

The Review Workflows feature allows you to create and manage workflows for your various content-types. Each workflow can consist of any review stages for your content, enabling your team to collaborate in the content creation flow from draft to publication.

Workflow list viewWorkflow list view

In many organizations different teams review different parts of content. By using different review workflows for different content-types, it is possible to adjust each workflow to the needs of each team involved.

The default workflow is configured to have 4 stages: To do, In progress, Ready to review, and Reviewed. All 4 stages can be edited, reordered or deleted as needed, and it is also possible to add new stages. Additionally, any stage can be defined as a required stage for publishing, ensuring content must pass through that stage before it can be published.

Before being available in the Content Manager, review workflows must be configured from Settings > Global settings > Review Workflows. The Review workflows settings are only available to users with the Super Admin role by default. Other roles must be granted the Review workflows permissions. See Users, Roles, & Permissions for more information.

Creating or editing a workflow

Workflow edit viewWorkflow edit view
  1. Click on the Create new workflow button or on the edit button of a workflow.

  2. In the workflow edit interface, configure the new workflow:

    Setting nameInstructions
    Workflow nameWrite a unique name of workflow.
    Associated to(optional) Assign this workflow to one or more existing content-types.
    StagesAdd review stages (see Adding a new stage).
    Required stageDefine any stage as required for publishing.
  3. Click on the Save button. The new workflow will be displayed in the list-view and for every content-type assigned.

Adding a new stage

To add a new stage in the review workflows:

  1. Click on the Add new stage button.
  2. Write the Stage name.
  3. Select a Color.
  4. Select Roles that can change the stage, if the entity is currently in that review stage.
  5. Click on the Save button.

By default new stages are appended, but they can be reordered anytime using the button.

Tip

To set up roles for each stage, you can either click "Apply to all stages" to apply the current roles to all other stages of the workflow or use "Duplicate stage" of the stage context menu.

Duplicating a stage

  1. Click Duplicate Stage in the context menu of the stage.
  2. Change the name of the duplicated stage.
  3. Click on the Save button.

Deleting a stage

To delete a stage, click in the context menu of the stage, then Delete.

If you delete a stage that has pending reviews, the reviews will be moved to first stage in the workflow. Every workflow needs to contain at least one stage and therefore it is not possible to delete the last stage.

Deleting a workflow

To delete a workflow click on the delete button of a workflow in the list view.

Note

It is not possible to delete the last workflow.