wagtail/docs/releases/5.2.md

Wagtail 5.2 release notes - IN DEVELOPMENT

Unreleased

---
local:
depth: 1
---

What's new

Other features

• Add wagtailcache and wagtailpagecache template tags to ensure previewing Pages or Snippets will not be cached (Jake Howard)
• Always set help text element ID for form fields with help text in field.html template (Sage Abdullah)
• Move SnippetViewSet menu registration mechanism to base ViewSet class (Sage Abdullah)
• Enable reference index tracking for models registered with ModelViewSet (Sage Abdullah)
• When copying a page or creating an alias, copy its view restrictions to the destination (Sandeep Choudhary, Suyash Singh)

Bug fixes

• Ensure that StreamField's FieldBlocks correctly set the required and aria-describedby attributes (Storm Heg)

Documentation

• Document WAGTAILADMIN_BASE_URL on "Integrating Wagtail into a Django project" page (Shreshth Srivastava)

Maintenance

• Fix snippet search test to work on non-fallback database backends (Matt Westcott)
• Update Eslint, Prettier & Jest npm packages (LB (Ben) Johnston)
• Add npm scripts for TypeScript checks and formatting SCSS files (LB (Ben) Johnston)
• Run tests in parallel in some of the CI setup (Sage Abdullah)
• Remove unused WorkflowStatus view, urlpattern, and workflow-status.js (Storm Heg)
• Add support for options/attrs in Telepath widgets so that attrs render on the created DOM (Storm Heg)
• Update pre-commit hooks to be in sync with latest changes to Eslint & Prettier for client-side changes (Storm Heg)
• Add WagtailTestUtils.get_soup() method for testing HTML content (Storm Heg, Sage Abdullah)
• Allow ViewSet subclasses to customise url_prefix and url_namespace logic (Matt Westcott)
• Simplify SnippetViewSet registration code (Sage Abdullah)

Upgrade considerations - changes affecting all projects

Upgrade considerations - deprecation of old functionality

Upgrade considerations - changes affecting Wagtail customisations

ModelViewSet automatically registers the model to the reference index

Models that are registered with a ModelViewSet now have reference index tracking enabled by default. This means that you no longer need to call ReferenceIndex.register_model() in your app's ready() method for such models. If this is undesired, you can disable it by setting {attr}~wagtail.admin.viewsets.model.ModelViewSet.add_to_reference_index to False on the ModelViewSet subclass. For more details, see .