Skip to main content

Adds functionality to add and edit a CMS guide page for editors.

Project description

Wagtail Guide

tests codecov

What is it?

The Wagtail Guide app adds functionality for creating and editing a guide for editors and publishers to help them create good content.


Wagtailguide has a pypi package and can be installed with:

pip install wagtail-guide

After installing, add it to your settings file along with wagtail.contrib.settings, the settings inclusion should be placed with your other wagtail.contrib libraries:


Settings and configuration

Wagtail guide has some customisation options...

WAGTAIL_GUIDE_MENU_LABEL Use this setting to define your own menu label for viewing the guide.

ADD_WAGTAIL_GUIDE_TO_HELP_MENU This setting will place the guide within the 'Help' menu.

HIDE_WAGTAIL_CORE_EDITOR_GUIDE You can use this setting to turn off the Wagtail core Editor Guide link

Examples of customisation via settings

Here is an example of a custom menu label (outlined here in orange), and placing the editor guide link in the help menu:

    "WAGTAIL_GUIDE_MENU_LABEL": "CMS Publishing Guide",

custom label

Here is an example of hiding the core Editor Guide link and just using ours:

    "WAGTAIL_GUIDE_MENU_LABEL": "CMS Publishing Guide",

remove help

You can define them in your project settings file like this:

    "WAGTAIL_GUIDE_MENU_LABEL": "WG guide menu label",


To edit the guide, the user needs to be an admin, or have the Manage editor guide 'change' value checked in their user group permissions.

Editing the guide

To edit the guide, from the left hand menu open settings > then click 'Manage editor guide'. Edit your content and then save.

guide edit

Guide navigation menu

If more than one 'heading' blocks are added to the content, an automatic menu will be displayed at the top of the guide under the heading 'Contents'

Viewing the guide

Once logged in, a new menu icon towards the bottom of the left hand menu will be visible labeled as 'Editor guide':

guide view


Wagtail Guide requires wagtail>=5.2


We welcome contributions to this project, see for more details.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wagtail_guide-2.2.0.tar.gz (11.8 kB view hashes)

Uploaded Source

Built Distribution

wagtail_guide-2.2.0-py3-none-any.whl (15.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page