Workflow defines the life cycle of content, including pages, reusable content items, headless items and emails. Each workflow has one or more custom steps between the default Draft and Published steps. This allows you to ensure the quality of content by setting up a reviewing and approval process tailored specifically for your organization.

An example of a simple workflow process is a website that publishes scientific articles. An author writes an article and sends it for approval to an editor who makes corrections and submits the article to the head of the respective department. The head then publishes the page, making it publicly accessible on the website.

Create a workflow

  1. Open the Workflows application.
  2. Select the New workflow button.
  3. Fill in the Workflow name and optionally a code name in the Identifiers section.
  4. Save the new workflow.

The workflow is now created and ready to be configured.

Configure the workflow scope

Once a workflow is created, you can define its scope. Each content type can be assigned a single workflow. If a content type is already associated with a workflow, it will be excluded from the available scope options.

  1. Select the workflow you want to configure.
  2. Switch to the Scope tab.
  3. Select content types and choose the types to which you want to apply the workflow. You can pick multiple content types. Types for pages, emails, reusable content and headless items are all supported.
  4. Save the selected content types.

Upon assigning a workflow to a content type, individual content items do not initiate the workflow automatically. The workflow applies only when an item starts a new editing cycle, which includes new items or new versions of existing published items.

The editing cycle ends when an item reaches the Published step. Existing items in the Draft step do not automatically use the workflow with custom steps until they are published and a new editing cycle starts. There is currently no alternative way to start the newly applied workflow with custom steps.

Configure the workflow steps

  1. Select the workflow you want to configure.

  2. On the Steps tab, select New step.

    New workflow step

  3. Fill in the following values:

    • Step name
    • (Optional) Identifiers – specify the code name if you wish to use a code name different than the pre-filled value.
      • Note: The code name of a workflow step must be unique across all workflows.
    • Icon
    • Roles that can work with this step – designates roles that are permitted to edit items in this step and move to the next or previous step. For the final custom step in the workflow, the chosen roles gain the ability to publish items or send/schedule regular emails.
  4. Save the step.

Repeat the process for all steps required for your workflow. You can drag steps in the list to change their order.

Delete a workflow and workflow steps

Workflows and steps cannot be deleted when there are existing items in the workflow steps, including the Draft status. Only items that have the workflow applied are considered, excluding items that were in the Draft step when the workflow was assigned to their content type.

If a workflow is removed from the content type (scope), items in the workflow editing cycle keep their current workflow with custom steps until they reach the Published step. If a new editing cycle starts (new item or new version of a published item), the default workflow with only Draft/Published/Archived statuses is used.