Contributing Guide

The goal of Wagtail SEO is to become the most complete, go-to package for doing SEO on Wagtail. This means it will not only provide the features, but will continually stay up to date with evolving SEO practices and data standards (and Google’s whims).

That being said we heartily welcome contributions!

Bugs, feature requests, and ideas should be opened first as a GitHub issue. Pull requests will be accepted provided they meet the project’s quality standards, and can be demonstrated to align with a published SEO or data standard.

Development Environment

To set up your development environment:

  1. Create a new environment (in a .venv folder):

    python -m venv .venv
    # Mac and Linux
    source ./.venv/bin/activate
    # Windows (PowerShell)
  2. Enter the source code directory and install the package locally with additional development tools:

    pip install -r requirements-dev.txt
  3. Write some code.

  4. Next, run the static analysis tools:

    black .
    codespell .
    flake8 .
    mypy ./wagtailseo/
  5. Next, run the units tests. A simple Wagtail project using Wagtail SEO is in the testproject/ directory. The tests will also generate a code coverage report at htmlcov/index.html, which you can open in your browser:

    pytest ./testproject/


To build the documentation, run the following, which will output to the docs/_build/html/ directory:

sphinx-build -M html ./docs/ ./docs/_build/ -W


To create a python package, run the following, which will output the package to the dist/ directory:

python sdist bdist_wheel