wagtail/docs/releases/6.2.md

Wagtail 6.2 release notes - IN DEVELOPMENT

Unreleased

---
local:
depth: 1
---

What's new

Alt text accessibility check

The built-in accessibility checker now enforces a new alt-text-quality rule, which tests alt text for the presence of known bad patterns such as file extensions. This rule is enabled by default, but can be disabled if necessary.

This feature was implemented by Albina Starykova, with support from the Wagtail accessibility team.

Other features

• Optimize and consolidate redirects report view into the index view (Jake Howard, Dan Braghis)
• Support a HOSTNAMES parameter on WAGTAILFRONTENDCACHE to define which hostnames a backend should respond to (Jake Howard, sponsored by Oxfam America)
• Refactor redirects edit view to use the generic EditView and breadcrumbs (Rohit Sharma)
• Allow custom permission policies on snippets to prevent superusers from creating or editing them (Sage Abdullah)
• Do not link to edit view from listing views if user has no permission to edit (Sage Abdullah)
• Allow access to snippets and other model viewsets to users with "View" permission (Sage Abdullah)
• Skip ChooseParentView if only one possible valid parent page availale (Matthias Brück)
• Add copy_for_translation_done signal when a page is copied for translation (Arnar Tumi Þorsteinsson)
• Remove reduced opacity for draft page title in listings (Inju Michorius)
• Adopt more compact representation for StreamField definitions in migrations (Matt Westcott)
• Implement a new design for locale labels in listings (Albina Starykova)
• Add a deactivate() method to ProgressController (Alex Morega)
• Allow manually specifying credentials for CloudFront frontend cache backend (Jake Howard)

Bug fixes

• Make WAGTAILIMAGES_CHOOSER_PAGE_SIZE setting functional again (Rohit Sharma)
• Enable richtext template tag to convert lazy translation values (Benjamin Bach)
• Ensure permission labels on group permissions page are translated where available (Matt Westcott)
• Preserve whitespace in comment replies (Elhussein Almasri)
• Address layout issues in the title cell of universal listings (Sage Abdullah)
• Support SVG icon id attributes with single quotes in the styleguide (Sage Abdullah)
• Do not show delete button on model edit views if per-instance permissions prevent deletion (Matt Westcott)
• Remove duplicate header in privacy dialog when a privacy setting is set on a parent page or collection (Matthias Brück)
• Allow renditions of .ico images (Julie Rymer)
• Fix the rendering of grouped choices when using ChoiceFilter in combination with choices (Sébastien Corbin)
• Add separators when displaying multiple error messages on a StructBlock (Kyle Bayliss)
• Specify verbose_name on TranslatableMixin.locale so that it is translated when used as a label (Romein van Buren)
• Disallow null characters in API filter values (Jochen Wersdörfer)
• Fix image preview when Willow optimizers are enabled (Alex Tomkins)
• Ensure external-to-internal link conversion works when the wagtail_serve view is on a non-root path (Sage Abdullah)
• Add missing for_instance method to PageLogEntryManager (Matt Westcott)

Documentation

• Remove duplicate section on frontend caching proxies from performance page (Jake Howard)
• Document restriction_type field on PageViewRestriction (Shlomo Markowitz)
• Document Wagtail's bug bounty policy (Jake Howard)
• Fix incorrect Sphinx-style code references to use MyST style (Byron Peebles)
• Document the fact that Orderable is not required for inline panels (Bojan Mihelac)
• Add note about prefers-reduced-motion to the accessibility documentation (Roel Koper)
• Update deployment instructions for Fly.io (Jeroen de Vries)

Maintenance

• Use DjangoJSONEncoder instead of custom LazyStringEncoder to serialize Draftail config (Sage Abdullah)
• Refactor image chooser pagination to check WAGTAILIMAGES_CHOOSER_PAGE_SIZE at runtime (Matt Westcott)
• Exclude the client/scss directory in Tailwind content config to speed up CSS compilation (Sage Abdullah)
• Split contrib.frontend_cache.backends into dedicated sub-modules (Andy Babic)
• Remove unused docs/autobuild.sh script (Sævar Öfjörð Magnússon)
• Replace urlparse with urlsplit to improve performance (Jake Howard)

Upgrade considerations - changes affecting all projects

Specifying a dict of distribution IDs for CloudFront cache invalidation is deprecated

Previous versions allowed passing a dict for DISTRIBUTION_ID within the WAGTAILFRONTENDCACHE configuration for a CloudFront backend, to allow specifying different distribution IDs for different hostnames. This is now deprecated; instead, multiple distribution IDs should be defined as multiple backends, with a HOSTNAMES parameter to define the hostnames associated with each one. For example, a configuration such as:

WAGTAILFRONTENDCACHE = {
    'cloudfront': {
        'BACKEND': 'wagtail.contrib.frontend_cache.backends.CloudfrontBackend',
        'DISTRIBUTION_ID': {
            'www.wagtail.org': 'your-distribution-id',
            'www.madewithwagtail.org': 'other-distribution-id',
        },
    },
}

should now be rewritten as:

WAGTAILFRONTENDCACHE = {
    'mainsite': {
        'BACKEND': 'wagtail.contrib.frontend_cache.backends.CloudfrontBackend',
        'DISTRIBUTION_ID': 'your-distribution-id',
        'HOSTNAMES': ['www.wagtail.org'],
    },
    'madewithwagtail': {
        'BACKEND': 'wagtail.contrib.frontend_cache.backends.CloudfrontBackend',
        'DISTRIBUTION_ID': 'other-distribution-id',
        'HOSTNAMES': ['www.madewithwagtail.org'],
    },
}

Upgrade considerations - deprecation of old functionality

Upgrade considerations - changes affecting Wagtail customisations

Upgrade considerations - changes to undocumented internals