Skip to main content
Select a folder name to open it. Its disclosure arrow controls whether its children appear in the left sidebar. Breadcrumbs let you return to an ancestor, including older ancestors available from the ellipsis menu. Filenames and folder names are labels. Use IDs when persisting a selection or addressing an API route.

What loads

  • A branch requests a page of child folders when needed. The default page has 50 folder summaries.
  • The virtual list renders the visible rows and a small overscan. Additional pages load with opaque cursors as you scroll.
  • On reload, Studio prepares the first pages of previous expanded branches within its expansion budget. It remembers expansion IDs in browser preferences. It does not read the entire library or eagerly exhaust continuation cursors.
  • A deeply nested link can use a contextual root. Its breadcrumbs contain a bounded tail and fetch older ancestors separately.

Configure the sidebar

Pass layout to your Studio instance. The cache option limits idle pages. Expanded branches have their own bounded windows. Set folderTree: false if your host provides the folder navigation itself.
The response contains folderId, root, tail, hasCollapsedAncestors, ancestorCursor, and the current workspace navigation revision. totalDepth may be null. Pass an available cursor to the ancestor endpoint and keep it opaque. If a change feed returns reset: true, fetch a fresh outline instead of continuing incremental replay from the previous revision.