XR components: App bars
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 app bar with custom specs and guidance. See XR developer documentation for more details.
Variants & configurations
There is one app bar orbiterOrbiters are floating elements that control the content within spatial panels.More on orbiters. It closely aligns with the small app barSmall app bars display information and actions in compact layouts. They're often used for scrolled views on subpages that require back navigation and multiple actions.More on small app bars. It can be configured to be center-aligned or left-aligned.

- Center-aligned app bar
- Left-aligned app bar
Anatomy

- Container
- Headline
- Trailing icons
- Leading icon
Color & elevation
XR uses color to communicate the elevation of UI elements and orbiters. With spatial elevation, the app bar 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 app bars can use any of these color options:

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

Usage
An app bar 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 app bar on the same plane as the body content to mimic a 2D experience.
Behavior
Global context
When placed in global context, the orbiter is centered at the top of the app it controls.
It stays anchored to the app during layout or content changes.
This ensures navigation elements are always easy to find and use.
Local context
When placed in local context, the orbiter is centered at the top of the spatial panel it controls.
It repositions in response to layout or content changes.
Additional app bars
In most cases, apps should only have one app bar orbiter, placed in global context.
Placement
Offset & inset positioning
In full space, an app bar orbiter can be positioned:
- Offset 20dp from the spatial panel
- Inset 12dp, overlapping spatial panel without obstructing content


Horizontal alignment


Spatial panel alignment
By default, app bar orbiters are center-aligned to the spatial panel. Their width and placement can be adjusted to accommodate specific user needs, such as improved ergonomics or right-to-left (RTL) languages.
Width boundaries
An app bar orbiter’s width should adjust to stay in a person’s natural field of view.
This makes crucial navigation elements easy to find.

It’s not recommended to increase the width of an app bar orbiter beyond a person’s natural field of view.
This creates a visual imbalance and makes it difficult to find navigation elements.

Adaptable width
When placed in a local context, an app bar orbiter can expand to the width of its adjacent spatial panel.
Be sure the orbiter stays in a person’s field of view, and test for usability.
Accessibility considerations
XR accessibility guidelines are still evolving. XR app bars should follow applicable Material app bar accessibility standards.