From 2254ec2470b281fa13aff55aec640e73fae84b6c Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Fri, 24 Jul 2026 02:22:19 +0000 Subject: [PATCH] Document Media Library bulk actions behind unstableMediaLibrary flag Co-Authored-By: Claude Sonnet 4.6 --- docusaurus/docs/cms/features/media-library.md | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) diff --git a/docusaurus/docs/cms/features/media-library.md b/docusaurus/docs/cms/features/media-library.md index 789c89de82..48854328a3 100644 --- a/docusaurus/docs/cms/features/media-library.md +++ b/docusaurus/docs/cms/features/media-library.md @@ -753,6 +753,59 @@ To add a focal point to an image: Assets can also be deleted individually or in bulk from the main view of the Media Library. Select assets by clicking on their checkbox in the top left corner, then click the Delete icon at the top of the window, below the filters and sorting options. ::: +### Bulk actions + +The future Media Library provides a bulk action bar for performing operations on multiple assets and folders simultaneously. Bulk actions are available in the table view of the future Media Library. + + + +#### Selecting assets and folders + +Each asset row in the table view has a leading checkbox. Select multiple items using the following methods: + +- Click a checkbox to select a single item. Clicking again deselects it. +- Cmd/Ctrl+click toggles an item without clearing the current selection. +- Shift+click selects a contiguous range from the last clicked item to the target. +- Click the header checkbox to select all items on the current page. The header checkbox shows an indeterminate state when some items are selected. + +:::note +Selection is page-scoped and resets when you navigate to a different folder. +::: + +When 1 or more assets or folders are selected, a floating bulk action bar appears at the bottom of the interface. The bar shows the number of selected items and the available actions. + + + +#### Bulk deleting assets and folders + +To delete multiple assets and folders at once: + +1. Select the assets and folders to delete using the checkboxes. +2. In the bulk action bar, click the delete icon . +3. In the confirmation dialog, review the item count and warning message. +4. Click **Confirm**. + +:::warning +Deleted items cannot be recovered. Deleting a folder also deletes all content inside it. Any content that links to deleted assets will break, and media containers will appear empty. +::: + + + +#### Bulk moving assets and folders + +To move multiple assets and folders to a different location: + +1. Select the assets and folders to move using the checkboxes. +2. In the bulk action bar, click the move icon . +3. In the **Move elements to** dialog, select a destination from the **Location** drop-down list. +4. Click **Move**. + +:::note +Folders in the current selection are excluded from the list of valid destinations. A folder cannot be moved into itself or into one of its descendants. +::: + + + ### Organizing assets with folders Folders in the Media Library help you organize uploaded assets. Folders sit at the top of the Media Library view or are accessible from the Media field popup when using the [Content Manager](/cms/features/content-manager).