Skip to content

Add folder sidebar navigation section to Media Library docs#3280

Draft
pwizla wants to merge 1 commit into
mainfrom
cms/add-media-library-folder-sidebar-navigation
Draft

Add folder sidebar navigation section to Media Library docs#3280
pwizla wants to merge 1 commit into
mainfrom
cms/add-media-library-folder-sidebar-navigation

Conversation

@pwizla

@pwizla pwizla commented Jun 19, 2026

Copy link
Copy Markdown
Collaborator

This PR updates documentation based on strapi/strapi#26551.

Generated automatically by the docs self-healing workflow.
Review before merging.

What changed

Added a new "Navigating with the folder sidebar" section (H4) inside ### Organizing assets with folders in docusaurus/docs/cms/features/media-library.md.

The section documents:

  • The persistent folder sidebar that displays the full folder hierarchy
  • How the sidebar loads from GET /upload/folder-structure
  • Folder selection behavior and ?folder= URL parameter sync
  • Automatic ancestor expansion for the active folder
  • Redirect to root on invalid/missing folder ID

Also updated the :::note in #### Adding folders to remove the now-stale claim that the Media Library has no visual hierarchy indication.

TODOs for reviewer

  • Feature flag: Confirm whether this sidebar requires enabling a future flag for the revamped Media Library. If it does, add the appropriate flag documentation and badge. If it's GA, remove the <!-- TODO --> comment.
  • Screenshot: Consider adding a screenshot showing the sidebar in context.
  • Stale note: The <!-- TODO --> comment on the Adding folders note flags it for removal/update once the sidebar is confirmed GA.

Documents the persistent folder sidebar introduced in strapi/strapi#26551:
folder hierarchy tree, ?folder= URL sync, auto-expand of ancestors,
and redirect behavior for invalid folder IDs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@pwizla pwizla added the auto-doc-healing Automatically generated documentation PR label Jun 19, 2026
@pwizla pwizla self-assigned this Jun 19, 2026
@vercel

vercel Bot commented Jun 19, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
documentation Ready Ready Preview, Comment Jun 19, 2026 8:34am

Request Review

@strapi-cla

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

@github-actions github-actions Bot added internal PRs created by the Strapi core team pr: updated content PRs updating existing documentation content source: CMS labels Jun 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

auto-doc-healing Automatically generated documentation PR internal PRs created by the Strapi core team pr: updated content PRs updating existing documentation content source: CMS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants