wagtail/docs/releases/4.1.md

Wagtail 4.1 release notes - IN DEVELOPMENT

---
local:
depth: 1
---

Wagtail 4.1 is designated a Long Term Support (LTS) release. Long Term Support releases will continue to receive maintenance updates as necessary to address security and data-loss related issues, up until the next LTS release (typically a period of 12 months).

What's new

Other features

• Add basic keyboard control and screen reader support for page listing re-ordering (Paarth Agarwal, Thomas van der Hoeven)
• Add PageQuerySet.private method as an alias of not_public (Mehrdad Moradizadeh)
• Most images in the admin will now only load once they are visible on screen (Jake Howard)
• Allow setting default attributes on image tags (Jake Howard)
• Optimise the performance of the Wagtail userbar to remove duplicated queries, improving page loads when viewing live pages while signed in (Jake Howard)
• Remove legacy styling classes for buttons and refactor button styles to be more maintainable (Paarth Agarwal, LB (Ben Johnston))
• Add button variations to the pattern library (Paarth Agarwal)
• Provide a more accessible page title where the unique information is shown first and the CMS name is shown last (Mehrdad Moradizadeh)
• Pull out behaviour from AbstractFormField to FormMixin and AbstractEmailForm to EmailFormMixin to allow use with subclasses of Page (Mehrdad Moradizadeh, Kurt Wall)
• Add a docs.wagtail.org/.well-known/security.txt so that the security policy is available as per the specification on https://securitytxt.org/ (Jake Howard)
• Add unit tests for the classnames Wagtail admin template tag (Mehrdad Moradizadeh)
• Show an inverse locked indicator when the page has been locked by the current user in reports and dashboard listings (Vaibhav Shukla, LB (Ben Johnston))
• Add clarity to the development documentation that admonition should not be used and titles for note are not supported, including clean up of some existing incorrect usage (LB (Ben Johnston))
• Unify the styling of delete/destructive button styles across the admin interface (Paarth Agarwal)

Bug fixes

• Prevent PageQuerySet.not_public from returning all pages when no page restrictions exist (Mehrdad Moradizadeh)
• Ensure that duplicate block ids are unique when duplicating stream blocks in the page editor (Joshua Munn)
• Revise colour usage so that privacy & locked indicators can be seen in Windows High Contrast mode (LB (Ben Johnston))
• Ensure that disabled buttons have a consistent presentation on hover to indicate no interaction is available (Paarth Agarwal)

Upgrade considerations

Button styling class changes

When adding custom buttons using the ModelAdmin ButtonHelper class, custom buttons will no longer include the button-secondary class by default in index listings.

If using the hook register_user_listing_buttons to register buttons along with the undocumented UserListingButton class, the button-secondary class will no longer be included by default.

The following button classes have been removed, none of which were being used within the admin but may have been used by custom code or packages:

• button-neutral
• button-strokeonhover
• hover-no
• unbutton
• yes