Documentation and release note for #8703

CHANGELOG.txt

@@ -73,6 +73,7 @@ Changelog
  * Add support for Twitter and other text-only embeds in Draftail embed previews (Iman Syed, Paarth Agarwal)
  * Use new modal dialog component for privacy settings modal (Sage Abdullah)
  * Add `menu_item_name` to modify MenuItem's name for ModelAdmin (Alexander Rogovskyy, Vu Pham)
+ * Add an extra confirmation prompt when deleting pages with a large number of child pages (Jaspreet Singh)
  * Fix: Typo in `ResumeWorkflowActionFormatter` message (Stefan Hammer)
  * Fix: Throw a meaningful error when saving an image to an unrecognised image format (Christian Franke)
  * Fix: Remove extra padding for headers with breadcrumbs on mobile viewport (Steven Steinwand)

docs/reference/settings.md

@@ -839,3 +839,13 @@ WAGTAIL_WORKFLOW_CANCEL_ON_PUBLISH = True
 
 This determines whether publishing a page with an ongoing workflow will cancel the workflow (if true) or leave the workflow unaffected (false).
 Disabling this could be useful if your site has long, multi-step workflows, and you want to be able to publish urgent page updates while the workflow continues to provide less urgent feedback.
+
+## Page deletion
+
+### `WAGTAILADMIN_UNSAFE_PAGE_DELETION_LIMIT`
+
+```python
+WAGTAILADMIN_UNSAFE_PAGE_DELETION_LIMIT = 20
+```
+
+This setting enables an additional confirmation step when deleting a page with a large number of child pages. If the number of pages is greater than or equal to this limit (10 by default), the user must enter the site name (as defined by `WAGTAIL_SITE_NAME`) to proceed.

docs/releases/4.0.md

@@ -93,6 +93,7 @@ Wagtail’s page preview is now available in a side panel within the page editor
  * Add support for Twitter and other text-only embeds in Draftail embed previews (Iman Syed, Paarth Agarwal)
  * Use new modal dialog component for privacy settings modal (Sage Abdullah)
  * Add `menu_item_name` to modify MenuItem's name for ModelAdmin (Alexander Rogovskyy, Vu Pham)
+ * Add an extra confirmation prompt when deleting pages with a large number of child pages (Jaspreet Singh)
 
 ### Bug fixes