Skip to content

Add folder sidebar navigation section to Media Library docs #3280

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
pwizla wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

Add folder sidebar navigation section to Media Library docs #3280

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 16 additions & 1 deletion docusaurus/docs/cms/features/media-library.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -780,6 +780,20 @@ To navigate back to the parent folder, one level up, use the **Back** button at
The breadcrumb navigation can also be used to go back to a parent folder: click on a folder name to directly jump to it or click on the 3 dots `/img.` and select a parent folder from the drop-down list.
:::

#### Navigating with the folder sidebar

<!-- TODO: Confirm whether this feature requires a future flag to enable the revamped Media Library -->

The Media Library includes a persistent folder sidebar on the left side of the interface. The sidebar displays the complete folder hierarchy, loaded from the `GET /upload/folder-structure` endpoint, so you can browse nested folders without clicking through each level in the main content area.

The sidebar shows a **Home** entry at the top, followed by all nested folders. Clicking a folder in the sidebar updates the main content area to show that folder's assets. The selected folder is reflected in the `?folder=` URL parameter.

Ancestors of the active folder expand automatically in the sidebar, giving you a visual indicator of your current location within the hierarchy.

If the URL contains an invalid or missing folder ID, the Media Library redirects to the root folder.

<!-- unverified: sidebar component behavior based on PR #26551 description; exact feature flag name unknown -->

#### Adding folders

1. Click on **Add new folder** in the upper right of the Media Library interface.
Expand All @@ -788,8 +802,9 @@ The breadcrumb navigation can also be used to go back to a parent folder: click
4. Click **Create**.

:::note
There is no limit to how deep your folders hierarchy can go, but bear in mind it might take some effort to reach a deeply nested subfolder, as the Media Library currently has no visual hierarchy indication. Searching for files using the <Icon name="magnifying-glass" classes="ph-bold" /> on the right side of the user interface might be a faster alternative to finding the asset you are looking for.
There is no limit to how deep your folders hierarchy can go, but bear in mind it might take some effort to reach a deeply nested subfolder. Searching for files using the <Icon name="magnifying-glass" classes="ph-bold" /> on the right side of the user interface might be a faster alternative to finding the asset you are looking for.
:::
<!-- TODO: Update or remove this note once the folder sidebar (see "Navigating with the folder sidebar") is confirmed as generally available, since the sidebar does provide visual hierarchy indication -->

#### Moving assets to a folder

Expand Down
Loading