Release notes for #13216

CHANGELOG.txt

@@ -34,6 +34,7 @@
  * Add a keyboard shortcut to easily toggle the visibility of the minimap side panel (Dhruvi Patel)
  * Add API for extracting preview page content (Sage Abdullah)
  * Add toggle from grid to list layout for image listings (Joel William)
+ * Add support for opt-in collapsible `StructBlock`s (Sage Abdullah)
  * Fix: Handle lazy translation strings as `preview_value` for `RichTextBlock` (Seb Corbin)
  * Fix: Fix handling of newline-separated choices in form builder when using non-windows newline characters (Baptiste Mispelon)
  * Fix: Ensure `WAGTAILADMIN_LOGIN_URL` is respected when logging out of the admin (Antoine Rodriguez, Ramon de Jezus)
@@ -58,6 +59,7 @@
  * Fix: Ensure keyboard usage will correctly focus on new comments, including replies, when the side panel is open or closed (Dhruvi Patel)
  * Fix: Handle `help_text` kwarg in `FloatBlock` (Nick Smith)
  * Fix: Set `aria-invalid` on StreamField widgets input when there is an error (Sage Abdullah)
+ * Fix: Make sure the label of panel collapse buttons is translatable (Thibaud Colas)
  * Docs: Add missing tag library imports to footer template code in tutorial (Dimaco)
  * Docs: Improve documentation around securing user-uploaded files (Jake Howard)
  * Docs: Introduce search_fields in a dedicated tutorial section instead of the introduction (Matt Westcott)

docs/releases/7.1.md

@@ -21,6 +21,20 @@ Image listings now support both grid and list layouts, with a simple toggle for
 
 Thank you to Joel William for implementing this as part of the [Google Summer of Code program](https://wagtail.org/blog/four-contributors-for-gsoc-2025/), with support from Coen van der Kamp, Sage Abdullah, Thibaud Colas, Ben Enright.
 
+### Collapsible StructBlock for block settings
+
+To make it easier to navigate complex structured content, blocks created with `StructBlock` can now be collapsed and expanded like other structured block types. This is an opt-in feature, requiring developers to set `collapsed=False` or `collapsed=True` when reusing the block, or as part of its `Meta` class. A common need for this is block settings, where the block supports a lot of optional fields:
+
+```python
+class BlockQuote(StructBlock):
+    text = TextBlock()
+    attribute_name = CharBlock(blank=True, required=False, label="e.g. Mary Berry")
+    # Fields within the settings block will be available but hidden by default.
+    settings = ThemeSettingsBlock(collapsed=True)
+```
+
+For more information, see [](custom_editing_interfaces_for_structblock) and [](streamfield_block_reference). This feature was implemented by Sage Abdullah, with support from the Wagtail UI team.
+
 ### Other features
 
  * Add iHeart oEmbed provider (Storm Heg)
@@ -78,6 +92,7 @@ Thank you to Joel William for implementing this as part of the [Google Summer of
  * Ensure keyboard usage will correctly focus on new comments, including replies, when the side panel is open or closed (Dhruvi Patel)
  * Handle `help_text` kwarg in `FloatBlock` (Nick Smith)
  * Set `aria-invalid` on StreamField widgets input when there is an error (Sage Abdullah)
+ * Make sure the label of panel collapse buttons is translatable (Thibaud Colas)
 
 ### Documentation