
Anatomy
The Side Nav consists of five primary elements that work together to display a list of links to move between pages.
- Item
- Selected item
- Group section
- Collapsible parent item
- Nested item
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Side Navs are used to display a list of links to move between pages.


| Standard | Requirement |
|---|---|
| DoDisplay links for moving between pages | Use the Side Nav to display a list of links for moving between pages. |
| DoMatch the app’s navigation structure | Use the Side Nav based on how the larger app organizes its navigation structure. In some cases this means the Side Nav is the top-level navigation tool, in others it may be a secondary system. |
| DoUse collapsible when hierarchy is clear | Use a collapsible Side Nav when users understand the categorization, helping them find items more effectively. Avoid this structure if there’s no clear parent-child relation in the nav, especially if users cannot perceive it. |
| DoUse flat for fewer or semi-related items | Use a flat Side Nav when items in a group lack a clear hierarchy. A flattened Side Nav is easier for users to navigate in this situation. |
| DoPair subheaders and collapsible in complex navs | Navigations with nuanced levels of hierarchy can use both subheaders and nesting at once. Simpler navigations should consider using only one grouping method. |
| DoShow metadata with Chips | A Chip can be paired with the Side Nav to provide metadata such as beta or new status, or a numerical value related to the Side Nav item. |
| Don’tMake a parent item a link | The Side Nav’s parent item can never be a link. If a parent item link is needed, a child item at the top may be used in its place, e.g., Overview. |
| Don’tUse multi-nested Navs | The Side Nav does not support deep navigation. Simplify the navigation structure first. If it cannot be simplified, a custom solution is needed. |
| Don’tAdd secondary actions | The Side Nav does not support secondary actions for accessibility reasons. Consider placing these actions elsewhere, such as on the page the Side Nav item goes to. |
| Key | Interaction |
|---|---|
| Down Arrow | Moves focus to next item |
| Up Arrow | Moves focus to previous item |
| Enter or Space | Selects item, expands/collapses. Focus stays on that item. |
Was this page helpful?