XR components: Toolbars
Learn how Material 3 Expressive components adapt to extended reality devices
TIP
XR guidelines are primarily intended for designers. Find what’s implemented in code in the design kit.
Extended reality (XR) interfaces have special design requirements, like showing apps in 3D space. Material has an XR toolbar with custom specs and guidance. Read XR developer documentation for more details.
Variants
There is one toolbar orbiterOrbiters are floating elements that control the content within spatial panels.More on orbiters. It closely aligns with the floating toolbarFloating toolbars float on top of page content and can provide contextual, dynamic actions.More on toolbars. It can be configured to be horizontal or vertical. Go to XR toolbar API reference

- Horizontal floating toolbar
- Vertical floating toolbar
Anatomy

- Container
- Placed components
Color & elevation
XR uses color to communicate the elevation of UI elements and orbiters. With spatial elevation, the toolbar displays above the spatial panelIn Android XR, a spatial panel is a container for UI elements, interactive components, and immersive content.More on spatial panels on the Z-axis. Elevated toolbars can use any of these color options:

- Surface container
- Surface container high
- Surface container highest
- Tertiary container
Measurements


Usage
A toolbar can appear in an orbiterOrbiters are floating elements that control the content within spatial panels.More on orbiters for a more immersive experience. Currently, this spatial capability is only available in full spaceFull space is Android XR’s immersive mode and supports spatial components.More on full space. In home spaceHome space is compatible with mobile and large screen apps, but doesn’t support spatial components.More on home space, use a regular toolbar on the same plane as the body content to mimic a 2D experience.
Behavior
Local context (recommended)
When placed in local context, the toolbar orbiter is centered at the bottom of the spatial panel it controls.
It repositions in response to layout or content changes.
Global context
When placed in global context, the toolbar orbiter is centered at the bottom of the app.
It stays anchored to the app during layout or content changes.
Expand & collapse
Toolbar orbiters with more than five items can expand and collapse to reveal or hide additional content.
When a toolbar orbiter expands, it stays within the bounds of the adjacent spatial panel.
Alternatively, more complex toolbars can be split into multiple toolbars.
Additional toolbars
In some cases, full space apps can have more than one toolbar orbiter, placed in either global or local context.
Placement
Offset & inset positioning
In full space, a toolbar orbiter can be positioned adjacent to or overlap a spatial panel.

- Offset by 20dp or
- Inset by 12dp

Horizontal alignment


Vertical alignment


Spatial panel alignment
By default, toolbar orbiters are center-aligned to the spatial panel. Their placement can be adjusted to accommodate specific user needs, such as improved ergonomics or right-to-left (RTL) languages.

Avoid placing a vertical toolbar orbiter between spatial panels.
This negatively affects the interface structure and can make it difficult to find.

Accessibility considerations
XR accessibility guidelines are still evolving. XR toolbars should follow applicable Material toolbar accessibility standards.