---
title: "Configure workflows for moderation"
description: "Workflows allow you to configure how moderation works on your site. Workflows are sequences of tasks, all of which must be approved before the workflow completes (by default, this results in the publication of the page, but depends on your site settings)."
last_modified: "2024-06-21"
---
> Documentation Index
> Fetch the complete documentation index at: https://guide.wagtail.org/llms.txt
> Use this file to discover all available pages before exploring further.

Page URL: https://guide.wagtail.org/en/how-to-guides/configure-workflows-for-moderation/

# Configure workflows for moderation

## On this page

- [About workflows](https://guide.wagtail.org/en/how-to-guides/configure-workflows-for-moderation/#about-workflows)
- [Edit workflows](https://guide.wagtail.org/en/how-to-guides/configure-workflows-for-moderation/#edit-workflows)
- [Create and edit tasks](https://guide.wagtail.org/en/how-to-guides/configure-workflows-for-moderation/#create-and-edit-tasks)

## About workflows

Workflows allow you to configure how moderation works on your site. Workflows are sequences of tasks that require approval before completion. A completed workflow usually results in the publication of a page, depending on your website's settings.

To access the Workflow interface, go to **Settings > Workflows** from the [Sidebar](https://guide.wagtail.org/en/how-to-guides/find-your-way-around/).

![Listing of workflows with a single Moderators approval workflow shown that has a single step](https://guide-media.wagtail.org/images/Listing_of_workflows_with_a_single_Moderators_.width-900_BfEuku6.png)

From the [Workflow interface](https://guide.wagtail.org/en/concepts/wagtail-interfaces/), you can see all of the workflows on your site and the order of tasks in each. To create a new workflow, click **Add a workflow** from the [Workflow interface](https://guide.wagtail.org/en/concepts/wagtail-interfaces/).

Furthermore, the [Workflow interface](https://guide.wagtail.org/en/concepts/wagtail-interfaces/) shows how many pages each workflow covers. If you click the number of pages, you can see a list of all the pages a workflow applies to.

## **Edit workflows**

In the [Workflow interface](https://guide.wagtail.org/en/concepts/wagtail-interfaces/), click on the name of a workflow to edit it or to assign it to a part of the page tree.

Click **Add task** under **Add tasks to your workflow** to add a task. When adding a task to a workflow, you can create a new task or reuse an existing one.

To change a task in the workflow, hover over the task under **Add tasks to your workflow** and select **Choose another task** from the pop-up options.

You can also reorder tasks in a workflow by hovering over a task under the **Add tasks to your workflow** and then clicking the up and down arrow.

Under **Assign your workflow to pages**, you can see a list of the pages assigned to a workflow. All child pages take the same workflow as their parents. So if the root page of your site gets assigned to a workflow, it becomes the default workflow. You may remove a page from the workflow by clicking **Delete** at the right of each entry. Also, you can change the page in an entry to another by clicking **Choose another page**.

The action menu at the bottom allows you to save your changes, or disable the workflow. Disabling a workflow cancels all pages currently in moderation in that workflow, and prevents others from starting it. If the workflow was previously disabled, then you get the option to enable it in the action menu.

![Screenshot of the workflow editing interface with fields to change the workflow name tasks and assigned pages](https://guide-media.wagtail.org/images/Screenshot_of_the_workflow_editing_interface_w.width-900_MbZ7ac3.png)

## Create and edit tasks

To create a task, go to **Settings > Workflows tasks** from the Sidebar. This takes you to the [Tasks interface](https://guide.wagtail.org/en/concepts/wagtail-interfaces/), where you can see a list of the currently available tasks and which workflows use each task. Similar to workflows, you can click the name of an existing task to edit it. To add a new task, click **Add a task**.

![Tasks listing with a single item](https://guide-media.wagtail.org/images/Tasks_listing_with_a_single_item_MvFdm6B.width-900.png)

When creating a task, if you have multiple task types available, then they are offered to you as options. By default, only *group approval tasks* are available. By creating a *group approval task*, you are able to select one or multiple groups. Members of any of these, as well as administrators, will be able to approve or reject moderation for this task.

![Tasks creation form with Name field and Groups checkboxes with two Moderators and Editors options](https://guide-media.wagtail.org/images/Tasks_creation_form_with_Name_field_and_Groups.width-900_Sf0WPeH.png)

When editing a task, you may find that some fields, such as the name field, are uneditable. This is to ensure workflow history remains consistent. If you need to change the name of a task, then disable the old task, and create a new one with the name you need. Disabling a task causes any pages currently in moderation on that task to skip to the next task.

*Last updated: June 21, 2024*


## Site Map

Here is a list of every page of this guide:

- [Wagtail user guide](https://guide.wagtail.org/en/markdown/): This documentation is written for anyone creating content or managing content production in Wagtail. It covers everything you can expect when using a standard Wagtail site.
    - [Getting started](https://guide.wagtail.org/en/getting-started/markdown/): Here are our step-by-step tutorials to learn Wagtail concepts.
        - [Overview](https://guide.wagtail.org/en/getting-started/overview/markdown/): If you're brand new to Wagtail, we recommend you go through our guides in sequence. Otherwise, you can click through the different categories below to learn more about different aspects of Wagtail.
    - [How-to guides](https://guide.wagtail.org/en/how-to-guides/markdown/): Use our guides to learn how to do a specific task in the CMS.
        - [Find your way around](https://guide.wagtail.org/en/how-to-guides/find-your-way-around/markdown/): This section describes the different pages that you will see as you navigate around the CMS, and how you can find the content that you are looking for.
        - [Manage pages](https://guide.wagtail.org/en/how-to-guides/manage-pages/markdown/): How to create, edit, copy, and manage pages in the Wagtail admin, including block-based editing, comments, privacy, history, and aliases.
        - [Manage documents](https://guide.wagtail.org/en/how-to-guides/manage-documents/markdown/): Documents such as PDFs can be managed from the Documents interface, available in the left-hand menu.
        - [Manage images](https://guide.wagtail.org/en/how-to-guides/manage-images/markdown/): If you want to edit, add or remove images from the CMS outside of the individual pages you can do so from the Images interface.
        - [Manage snippets](https://guide.wagtail.org/en/how-to-guides/manage-snippets/markdown/): Snippets allow you to create elements on a website once and reuse them in multiple places.
        - [Manage forms](https://guide.wagtail.org/en/how-to-guides/manage-forms/markdown/): Build and manage forms from the Wagtail admin without any technical expertise, and review the submissions they collect.
        - [Manage collections](https://guide.wagtail.org/en/how-to-guides/manage-collections/markdown/): Access to specific sets of images and documents can be controlled by setting up ‘collections’.
        - [Manage redirects](https://guide.wagtail.org/en/how-to-guides/manage-redirects/markdown/): A redirect ensures that when a page is no longer available (404), the visitor and search engines are sent to a new page.
        - [Manage users and roles](https://guide.wagtail.org/en/how-to-guides/manage-users-and-roles/markdown/): As an administrator, a common task will be adding, modifying or removing user profiles.
        - [Manage sites](https://guide.wagtail.org/en/how-to-guides/manage-sites/markdown/): Learn how to manage Wagtail sites: list, add, edit, copy, and delete the site configurations that map hostnames to your page tree.
        - [Promote search results](https://guide.wagtail.org/en/how-to-guides/promote-search-results/markdown/): Promoted search results are an optional Wagtail feature. For details of how to enable them on a Wagtail installation, see Promoted search results.
        - [Manage API tokens](https://guide.wagtail.org/en/how-to-guides/manage-api-tokens/markdown/): API tokens let applications and integrations connect to the Wagtail API on behalf of a user account. Learn how to create, rename, and revoke them.
    - [Concepts](https://guide.wagtail.org/en/concepts/markdown/): Wagtail has strong opinions about CMS best practices. This section describes why Wagtail works how it does from a user’s perspective.
        - [Wagtail interfaces](https://guide.wagtail.org/en/concepts/wagtail-interfaces/markdown/): A Wagtail interface is a screen in the Wagtail portal where you can manage a particular content type. The following are the several interfaces available to you in the Wagtail CMS.
        - [Pages](https://guide.wagtail.org/en/concepts/pages/markdown/): You can use Wagtail Pages to organize the content of your Wagtail websites. It's common for a typical website to have multiple web pages, and the web pages themselves can have several sections. The same is true for Wagtail pages.
        - [Reports](https://guide.wagtail.org/en/concepts/reports/markdown/): Reports are lists of pages that match a specific search. These lists give you an overview of the different actions taken on your website.
        - [Users status](https://guide.wagtail.org/en/concepts/users-status/markdown/): A Wagtail user can either be active or inactive. A user is active if they have the right permissions to log in and perform any action in the Admin interface.
        - [Page status](https://guide.wagtail.org/en/concepts/page-status/markdown/): Page status has to do with the current state of your pages. Your pages can be in one of seven different states.
        - [Accessibility features](https://guide.wagtail.org/en/concepts/accessibility-features/markdown/): An overview of the accessibility features built into the Wagtail admin interface, including navigation, keyboard support, and screen reader aids.
        - [Scheduled publishing](https://guide.wagtail.org/en/concepts/scheduled-publishing/markdown/): Schedule pages and snippets to go live at a specific date and time, and manage scheduled content revisions.
        - [Wagtail API](https://guide.wagtail.org/en/concepts/wagtail-api/markdown/): The Wagtail API lets other applications and integrations read, create, edit, and publish your content, with the same permissions and rules as the Admin interface.
    - [Reference](https://guide.wagtail.org/en/reference/markdown/): Our reference material gets to the point, giving the key information at a glance.
        - [Browser compatibility](https://guide.wagtail.org/en/reference/browser-compatibility/markdown/): For the best experience and security, we recommend that you keep your browser up to date.
        - [Content checks](https://guide.wagtail.org/en/reference/content-checks/markdown/): A built-in content quality checker system to meet high standards on accessibility, SEO, tone of voice, and any other aspect of content performance.
            - [Page metadata](https://guide.wagtail.org/en/reference/content-checks/page-metadata/markdown/): How Wagtail checks page metadata fields, including previews for search engines and other crawlers
        - [Account settings](https://guide.wagtail.org/en/reference/account-settings/markdown/): User account settings are specific to your account. Includes user preferences, notification settings, and more.
        - [Multi-site](https://guide.wagtail.org/en/reference/multi-site/markdown/): Reference for running multiple websites with Wagtail: how sites map hostnames to pages, and multi-site, multi-instance and multi-tenancy compared.
    - [Releases](https://guide.wagtail.org/en/releases/markdown/): Here are overviews of changes made to Wagtail in specific new releases.
        - [New in Wagtail 8.1](https://guide.wagtail.org/en/releases/new-in-wagtail-8-1/markdown/): Discover Wagtail 8.1: SEO metadata directly in content checks, better sitemaps for multilingual sites, and API v3 improvements
        - [New in Wagtail 8.0](https://guide.wagtail.org/en/releases/new-in-wagtail-8-0/markdown/): Discover Wagtail 8.0: the new v3 API to create, edit, and publish content programmatically, plus improvements to the site switcher, workflow details, and image handling.
        - [New in Wagtail 7.4](https://guide.wagtail.org/en/releases/new-in-wagtail-7-4/markdown/): Explore Wagtail 7.4: refined autosave, draft‑saving incomplete blocks, customizable listings, enhanced search, content checks, UI tweaks, and security fixes.
        - [New in Wagtail 7.3](https://guide.wagtail.org/en/releases/new-in-wagtail-7-3/markdown/): New features and other highlights from Wagtail 7.3: autosave, llms.txt, image performance
        - [New in Wagtail 7.2](https://guide.wagtail.org/en/releases/new-in-wagtail-7-2/markdown/): Highlights from the new admin features in Wagtail 7.2
        - [New in Wagtail 7.1](https://guide.wagtail.org/en/releases/new-in-wagtail-7-1/markdown/): Highlights from the new admin features in Wagtail 7.1
        - [New in Wagtail 7.0](https://guide.wagtail.org/en/releases/new-in-wagtail-7-0/markdown/): Highlights from the new admin features in Wagtail 7.0
        - [New in Wagtail 6.4](https://guide.wagtail.org/en/releases/new-in-wagtail-6-4/markdown/): Highlights from the new admin features in Wagtail 6.4
        - [New in Wagtail 6.3](https://guide.wagtail.org/en/releases/new-in-wagtail-6-3/markdown/): Highlights from the new admin features in Wagtail 6.3
        - [New in Wagtail 6.2](https://guide.wagtail.org/en/releases/new-in-wagtail-6-2/markdown/): Highlights from the new admin features in Wagtail 6.2
        - [New in Wagtail 6.1](https://guide.wagtail.org/en/releases/new-in-wagtail-6-1/markdown/): Highlights from the new admin features in Wagtail 6.1
        - [New in Wagtail 6.0](https://guide.wagtail.org/en/releases/new-in-wagtail-6-0/markdown/): Highlights from the new admin features in Wagtail 6.0
        - [New in Wagtail 5.2](https://guide.wagtail.org/en/releases/new-in-wagtail-5-2/markdown/): Highlights from the new admin features in Wagtail 5.2
        - [New in Wagtail 5.1](https://guide.wagtail.org/en/releases/new-in-wagtail-5-1/markdown/): Here are highlights from Wagtail 5.0. For more details, view the full v5.0 release notes.
        - [New in Wagtail 5.0](https://guide.wagtail.org/en/releases/new-in-wagtail-5-0/markdown/): Here are highlights from Wagtail 5.0. For more details, view the full v5.0 release notes.
        - [New in Wagtail 4.2](https://guide.wagtail.org/en/releases/new-in-wagtail-4-2/markdown/): With Wagtail 4.0, 4.1, and now 4.2 – we've added many substantial updates to the Wagtail page editor as well as some other tools that support every member of a content team.
        - [New in Wagtail 4.1](https://guide.wagtail.org/en/releases/new-in-wagtail-4-1/markdown/): With Wagtail 4.0 and 4.1, we've added many substantial updates to the Wagtail page editor as well as some other tools that support every member of a content team.
    - [About](https://guide.wagtail.org/en/about/markdown/): The User Guide is a website to help content editors, moderators, administrators, and other users learn how to use the Wagtail content management system (CMS).
        - [Privacy policy](https://guide.wagtail.org/en/about/privacy-policy/markdown/): What information the Wagtail User Guide collects when you visit or use the site, why we collect it, and who we share it with.
        - [Documentation formats](https://guide.wagtail.org/en/about/documentation-formats/markdown/): The user guide is available in different formats, for people and for their agents: web pages, Markdown, llms.txt, an agent skill, a Model Context Protocol server, WebMCP tools, and an API.
        - [Digital emissions](https://guide.wagtail.org/en/about/digital-emissions/markdown/): How we measure the Wagtail User Guide's carbon emissions, and the services the site relies on.
