> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Folders

> Containers that group Pages and other Folders into a navigable hierarchy.

A **folder** is a container in the sidebar that holds [pages](/surfaces/navigation/pages), other folders, or both. Folders are how you give a [section](/surfaces/navigation/sections) structure, grouping related pages together so your workspace stays organized as it grows.

## Nesting

A folder can hold pages and a level of sub-folders, so you can group related pages a couple of levels deep. Enough to match how a team works without the sidebar turning into a maze:

* `Sales → Deals → Deal List`
* `Success → Active clients → Onboarding`

<Note>
  Folder nesting is capped at a few levels (a folder, a sub-folder, then pages): deep enough to organize, shallow enough to stay scannable.
</Note>

## Where folders fit

Folders sit in the middle of the navigation hierarchy:

| Layer                                    | Role                                          |
| ---------------------------------------- | --------------------------------------------- |
| [Section](/surfaces/navigation/sections) | Top-level area, usually a department.         |
| **Folder**                               | Groups pages and other folders; nests freely. |
| [Page](/surfaces/navigation/pages)       | Opens a Surface with one or more views.       |

## Using folders

<Steps>
  <Step title="Create a folder">
    Inside a section (or another folder), add a new folder and give it a clear, short name.
  </Step>

  <Step title="Add pages or sub-folders">
    Place pages directly in the folder, or nest more folders to break a large area into sub-topics.
  </Step>

  <Step title="Reorganize anytime">
    Move pages and folders between containers as your structure evolves.
  </Step>
</Steps>

<Tip>
  Keep names concise so the sidebar stays easy to scan, and revisit your folder structure periodically as your team grows.
</Tip>

## See also

<CardGroup cols={2}>
  <Card title="Navigation Overview" icon="compass" href="/surfaces/navigation/overview" />

  <Card title="Sections" icon="table-list" href="/surfaces/navigation/sections" />

  <Card title="Pages" icon="file" href="/surfaces/navigation/pages" />
</CardGroup>


## Related topics

- [Navigation Overview](/surfaces/navigation/overview.md)
- [Reusables](/surfaces/components/reusables.md)
- [Sections](/surfaces/navigation/sections.md)
- [Page recovery](/surfaces/navigation/page-recovery.md)
- [Surfaces](/surfaces/overview.md)