5.0.2 release notes

July 27, 2025

Welcome to django CMS 5.0.2!

These release notes cover the new features, as well as some backwards incompatible changes you’ll want to be aware of when upgrading from django CMS 4.1 or earlier. We’ve begun the deprecation process for some features.

Django and Python compatibility

django CMS supports Django 4.2, 5.0, 5.1, and 5.2. We highly recommend and only support the latest release of each series.

It supports Python 3.10, 3.11, 3.12, and 3.13. As for Django we highly recommend and only support the latest release of each series.

How to upgrade to 5.0.2

Update your project’s requirements.txt file to require (at least) django CMS 5.0.2 and run pip install -r requirements.txt.

If you are upgrading from an earlier version of django CMS, read the release notes for all the versions between your current version and this one. Check the release notes for each version to see if there are any special instructions.

Run migrations:

python -m manage migrate

Warning

Since the migrations merge the TreeNode and Page models, you should run the migration in a test environment first to ensure that the migration runs successfully.

What’s new in 5.0.2

Bug Fixes:

  • The headless template included inline CSS (#8291) (#8292) (14dd89faf) – Fabian Braun

  • GrouperAdmin Search in content model (#8284) (#8290) (46f0e0775) – Muhammad Hassan Siddiqi

  • Allow clicks to propagate to plugins (#8288) (#8289) (2c1ab2d7d) – Fabian Braun

  • show_placeholder did not respect edit/preview mode and failed loudly (#8272) (#8274) (e7be7bc9b) – Fabian Braun

  • Allow lazy wizard initialization (#8265) (365185848) – Fabian Braun

  • Apphook widgets were not always detected correctly (#8263) (ec2f4e815) – Fabian Braun

  • Migrating from django CMS 3.x failed in some rare cases (#8249) (bcf7f895a) – jmit-modern

  • Added default_auto_field to cms/apps.py (#8254) (4a12dd38a) – Fabian Braun

  • 404 not raised in CMS view when no URLs matched (#8240) (3d069cbe5) – Stefan Wehrmeyer

  • Replaced outdated usage of page__node__path with page__path (#8238) (a9105a738) – Stefan Wehrmeyer

Statistics:

This release includes 13 pull requests, and was created with the help of the following contributors (in alphabetical order):

  • Fabian Braun (6 pull request)

  • Github Release Action (3 pull requests)

  • jmit-modern (1 pull request)

  • Muhammad Hassan Siddiqi (1 pull request)

  • Stefan Wehrmeyer (2 pull requests)

With the review help of the following contributors:

  • Fabian Braun

  • Vinit Kumar

Thanks to all contributors for their efforts!