wagtail/docs/releases/6.4.md

# Wagtail 6.4 release notes - IN DEVELOPMENT

_Unreleased_

```{contents}
---
local:
depth: 1
---
```

## What's new


### Other features

 * Add the ability to apply basic Page QuerySet optimizations to `specific()` sub-queries using `select_related` & `prefetch_related`, see [](../reference/pages/queryset_reference.md) (Andy Babic)

### Bug fixes

 * Improve handling of translations for bulk page action confirmation messages (Matt Westcott)
 * Ensure custom rich text feature icons are correctly handled when provided as a list of SVG paths (Temidayo Azeez, Joel William, LB (Ben) Johnston)
 * Ensure manual edits to `StreamField` values do not throw an error (Stefan Hammer)

### Documentation

 * Move the [model reference page](../reference/models.md) from reference/pages to the references section as it covers all Wagtail core models (Srishti Jaiswal)
 * Move the [panels reference page](../reference/panels.md) from references/pages to the references section as panels are available for any model editing, merge panels API into this page (Srishti Jaiswal)
 * Move the tags documentation to standalone [advanced topic for tagging](../advanced_topics/tags.md), instead of being inside the reference/pages section (Srishti Jaiswal)
 * Refine the [](adding_reports) page so that common (page/non-page) class references are at the top and the full page only example has correct heading nesting (Alessandro Chitarrini)
 * Add the [`wagtail start`](wagtail_start) command to the management commands reference page (Damilola Oladele)
 * Refine the [](project_templates_reference) page sections and document common issues encountered when creating custom templates (Damilola Oladele)
 * Refine page titles to better align with the documentation style guide (Srishti Jaiswal)

### Maintenance

 * Close open files when reading within utils/setup.py (Ataf Fazledin Ahamed)


## Upgrade considerations - changes affecting all projects

## Upgrade considerations - deprecation of old functionality

## Upgrade considerations - changes affecting Wagtail customizations

## Upgrade considerations - changes to undocumented internals
Start new release notes sections for 6.4 2024-10-22 17:37:04 +00:00			`# Wagtail 6.4 release notes - IN DEVELOPMENT`

			`_Unreleased_`

			```{contents}
			`---`
			`local:`
			`depth: 1`
			`---`
			```

			`## What's new`


			`### Other features`

Support application of select_related and prefetch_related lookups to subqueries made by SpecificIterable - Add queryset methods to reference docs, and provide performance considerations for prefetch_related() 2024-09-19 16:49:19 +00:00			* Add the ability to apply basic Page QuerySet optimizations to `specific()` sub-queries using `select_related` & `prefetch_related`, see [](../reference/pages/queryset_reference.md) (Andy Babic)
Start new release notes sections for 6.4 2024-10-22 17:37:04 +00:00
			`### Bug fixes`

Improve i18n of success message for bulk page actions (#12453) Previously, translations for messages such as "1 page and 3 child pages have been published" were handled with separate branches for the "one parent page" vs "multiple parent pages" cases, to work around ngettext only being able to handle pluralisation for one item in the string. This fails for languages such as Polish where the pluralisation does not follow the straightforward one/many distinction. Instead, we can translate "N pages" and "N child pages" separately before forming the final message. We generally avoid translating sentence fragments in isolation as this can make things difficult for translators if the sentence structure does not match the English version - but this is hopefully an improvement over the current situation, as well as simplifying the code and reducing repetition. 2024-10-23 10:33:45 +00:00			`* Improve handling of translations for bulk page action confirmation messages (Matt Westcott)`
Changelog for #11122 & #12418 2024-10-27 09:47:23 +00:00			`* Ensure custom rich text feature icons are correctly handled when provided as a list of SVG paths (Temidayo Azeez, Joel William, LB (Ben) Johnston)`
Fix StreamValue._prefetch_blocks() to skip manually inserted items Fixes #12320 2024-09-16 09:48:40 +00:00			* Ensure manual edits to `StreamField` values do not throw an error (Stefan Hammer)
Start new release notes sections for 6.4 2024-10-22 17:37:04 +00:00
			`### Documentation`

Add changelog entry for docs changes #12437 Fixes #12435 2024-10-25 10:07:11 +00:00			`* Move the [model reference page](../reference/models.md) from reference/pages to the references section as it covers all Wagtail core models (Srishti Jaiswal)`
			`* Move the [panels reference page](../reference/panels.md) from references/pages to the references section as panels are available for any model editing, merge panels API into this page (Srishti Jaiswal)`
			`* Move the tags documentation to standalone [advanced topic for tagging](../advanced_topics/tags.md), instead of being inside the reference/pages section (Srishti Jaiswal)`
Documentation - Refine the adding reports page - Move all generic (page/non-page) class references to the top of the documentation - Use better heading level nesting cleanly isolate the full page report example - Relates to #12428 2024-10-22 12:48:29 +00:00			`* Refine the [](adding_reports) page so that common (page/non-page) class references are at the top and the full page only example has correct heading nesting (Alessandro Chitarrini)`
Documentation - Improve project template (wagtail start) & add to management commands reference Fixes #11938 * Add `wagtail start` to the management commands reference * Add detail on how to creating templates with the need to escape template syntax by using the verbatim tag 2024-05-22 13:39:48 +00:00			* Add the [`wagtail start`](wagtail_start) command to the management commands reference page (Damilola Oladele)
			`* Refine the [](project_templates_reference) page sections and document common issues encountered when creating custom templates (Damilola Oladele)`
Documentation - Update page titles to align with Style Guide - Use sentence case for headings and titles. (as per the Google Developer Documentation Style Guide) - Fixes #12466 2024-10-25 17:21:02 +00:00			`* Refine page titles to better align with the documentation style guide (Srishti Jaiswal)`
Start new release notes sections for 6.4 2024-10-22 17:37:04 +00:00
			`### Maintenance`

Close open files when reading within utils/setup.py 2024-09-30 21:06:08 +00:00			`* Close open files when reading within utils/setup.py (Ataf Fazledin Ahamed)`
Start new release notes sections for 6.4 2024-10-22 17:37:04 +00:00

			`## Upgrade considerations - changes affecting all projects`

			`## Upgrade considerations - deprecation of old functionality`

Docs - update spelling to US 'customizations' 2024-10-25 11:01:21 +00:00			`## Upgrade considerations - changes affecting Wagtail customizations`
Start new release notes sections for 6.4 2024-10-22 17:37:04 +00:00
			`## Upgrade considerations - changes to undocumented internals`