Search: Specs
Search lets people enter a keyword or phrase to get relevant information
Variants
| Variant | M3 | M3 Expressive |
|---|---|---|
| Search | Available | Available |
Configurations
Style
Search comes in two styles:
- Contained: Has an expressive look and feel. It uses a filled container to separate a search bar from a list of suggestions or results
- Divided (baseline): Doesn't have the latest visual style, motion, or flexibility


Layout
Search suggestions and results appear in customizable lists, with two layout options: full-screen and docked. More on search layouts




| Category | Configuration | M3 | M3 Expressive |
|---|---|---|---|
| Style | Contained | -- | Available |
| Divided | Available | Not recommended. Use contained. | |
| Layout | Docked, full-screen | Available | Available |
Tokens & specs
Use the table's menu to select a token set. The search bar set only contains tokens for the unfocused search bar. The search view set contains all other tokens when interacting with search, including all styles and layouts. Learn more about design tokens
Search - View
| Token | Value |
|---|---|
| Search view container surface tint layer color | #6750A4 |
Search - Bar
Anatomy
Search includes a search bar and a container for suggestions and results. The container is empty by default. Use the list component to add content. In the divided (baseline) style, a divider separates the search bar and results.

- Search bar container
- Leading icon
- Supporting text
- Trailing icon and avatar (optional)
- Input text
- Container for search suggestions or results
Examples
- With avatar
- With one trailing icon button
- With two trailing icon buttons
- With trailing icon button and avatar

Color
Color values are implemented through design tokens. For designers, this means working with color values that correspond with tokens. In implementation, a color value will be a token that references a value.
Full-screen layout

Full-screen search color roles used in light and dark themes:
- Surface container low
- On surface variant
- On surface variant
- Surface container high
- On surface variant
- On surface
Docked layout

Docked search color roles used in light and dark themes:
- Surface container high
- On surface variant
- On surface variant
- Surface container high
- On surface variant
- On surface
States
States are visual representations used to communicate the status of a component or an interactive element. In focused search, individual elements maintain their own interaction states. Learn more about interaction states
Search bar

- Enabled
- Hovered
- Focused
- Pressed (ripple)
Search suggestions & results
Search includes a container for suggestions and results. The container is empty by default. Use the list component to add content.

- Enabled
- Hovered
- Focused
- Pressed (ripple)
Measurements
Search bar


In M3 Expressive, the search bar expands when focused. The margins change from 24dp to 12dp.


| Element | Attribute | Value |
|---|---|---|
| Container | Width | Min: 360dp, max: 720dp |
| Height | 56dp | |
| Label alignment | Start-aligned | |
| Leading padding | Unfocused: 24dp, focused: 12dp | |
| Trailing padding | Unfocused: 24dp, focused: 12dp | |
| Leading icon and label padding (from tap target) | 4dp | |
| Label and trailing icon padding (from tap target) | 4dp | |
| Avatar | Size | 30dp |
Focused search
Contained style


| Element | Attribute | Value |
|---|---|---|
| Full-screen container | Width | Full width |
| Height | Full height | |
| Docked container | Width | Min: 360dp, max: 720dp |
| Height | Min: 240dp, max: 2/3 of screen height | |
| Search bar container | Height | 56dp |
| Label alignment | Start-aligned | |
| Leading padding | 16dp | |
| Trailing padding | 16dp | |
| Leading icon and label padding (from tap target) | 4dp | |
| Leading icon and label padding (from tap target) | 4dp |
Divided style

