v3.0.0 release notes

New features

  • Support Wagtail 5.0, 5.1, and 5.2.

  • Support Python 3.8 to 3.12

  • Includes Bootstrap 5.3

  • New projects now include EventPage and LocationPage in models.py by default.

  • New project template: pro. This is the highly recommended starting point for larger projects or paying clients. It includes:

    • Custom User, Image, and Document models by default.

    • ruff linter and formatter pre-configured.

    • pytest pre-configured.

    • mypy pre-configured.

Bug fixes

  • Remove discontinued Google Analytics (Universal Analytics). This was shut down by Google in June 2023.

  • Fix issues with custom image models. A bug was introduced in some migrations with 2.0 which hard-coded the wagtail image class in some snippets.

Upgrade considerations

This should be a straightforward upgrade with no major functional changes.

Be sure to read the Wagtail 5 upgrade considerations.

If you’d like to add our new developer tooling to your existing project, copy the pyproject.toml and requirements-dev.txt. files.

Thank you!

Thanks to everyone who contributed to 3.0.0 on GitHub.