Skip to content
Material Design 3
Main Navigation
v3
v2
v1

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Appearance

Sidebar Navigation

Foundations

Accessibility

Overview: Principles

Overview: Assistive technology

Designing: Overview

Designing: Color contrast

Designing: Structure

Designing: Flow

Designing: Elements

Writing and text: Best practices

Writing and text: Text truncation

Writing and text: Text resizing

Building for all: User needs

Building for all: Co-design

Content design

Overview

Alt text

Global writing: Overview

Global writing: Word choice

Notifications

Style guide: UX writing best practices

Style guide: Word choice

Style guide: Grammar and punctuation

Customizing Material

Devices

Watches: Overview

Watches: Foundations

Watches: Styles

Watches: Layout

XR

Design: Overview

Design: Interaction

Design: Layout

Design: Accessibility

Components: Overview

Components: App bars

Components: Dialogs

Components: Nav bar

Components: Nav rail

Components: Toolbars

Design tokens: Overview

Design tokens: How to use tokens

Interaction

Gestures

Inputs

Selection

States: Overview

States: State layers

States: Applying states

Layout

Overview: Overview

Overview: Parts of layout

Overview: Adaptive design

Scaffold: Overview

Scaffold: Bars

Scaffold: Rails

Scaffold: Panes

Grids & spacing: Overview

Grids & spacing: Grids

Grids & spacing: Spacing

Grids & spacing: Density

Breakpoints: Overview

Breakpoints: Compact

Breakpoints: Medium

Breakpoints: Expanded

Breakpoints: Large & extra-large

Bidirectionality & RTL

Canonical examples: Overview

Canonical examples: Feed

Canonical examples: List-detail

Canonical examples: Supporting pane

Usability: Overview

Usability: Applying M3 Expressive

Material A-Z

Styles

Color

Color system: Overview

Color system: How the system works

Color roles

Color schemes

Choosing a scheme

Static: Baseline

Static: Custom brand

Dynamic: Choosing a source

Dynamic: User-generated source

Dynamic: Content-based source

Advanced: Overview

Advanced: Apply colors

Advanced: Define new colors

Advanced: Adjust existing colors

Color resources

Elevation: Overview

Elevation: Applying elevation

Elevation: Tokens

Icons: Overview

Icons: Designing icons

Icons: Applying icons

Motion

Motion physics system: How it works

Motion physics system: Specs

Easing and duration: Applying easing and duration

Easing and duration: Tokens & specs

Transitions: Transition patterns

Transitions: Applying transitions

Shape: Overview & principles

Shape: Corner radius scale

Shape: Shape morph

Spacing: Overview

Spacing: Applying spacing

Spacing: Tokens

Typography: Overview

Typography: Fonts

Typography: Type scale & tokens

Typography: Applying type

Typography: Editorial treatments

Components

App bars: Overview

App bars: Specs

App bars: Guidelines

App bars: Accessibility

Badges: Overview

Badges: Specs

Badges: Guidelines

Badges: Accessibility

Buttons

All buttons

Button groups: Overview

Button groups: Specs

Button groups: Guidelines

Button groups: Accessibility

Buttons: Overview

Buttons: Specs

Buttons: Guidelines

Buttons: Accessibility

Extended FABs: Overview

Extended FABs: Specs

Extended FABs: Guidelines

Extended FABs: Accessibility

FAB menu: Overview

FAB menu: Specs

FAB menu: Guidelines

FAB menu: Accessibility

FABs: Overview

FABs: Specs

FABs: Guidelines

FABs: Accessibility

Icon buttons: Overview

Icon buttons: Specs

Icon buttons: Guidelines

Icon buttons: Accessibility

Segmented buttons: Overview

Segmented buttons: Specs

Segmented buttons: Guidelines

Segmented buttons: Accessibility

Split button: Overview

Split button: Specs

Split button: Guidelines

Split button: Accessibility

Cards: Overview

Cards: Specs

Cards: Guidelines

Cards: Accessibility

Carousel: Overview

Carousel: Specs

Carousel: Guidelines

Carousel: Accessibility

Checkbox: Overview

Checkbox: Specs

Checkbox: Guidelines

Checkbox: Accessibility

Chips: Overview

Chips: Specs

Chips: Guidelines

Chips: Accessibility

Date & time pickers

Date pickers: Overview

Date pickers: Specs

Date pickers: Guidelines

Date pickers: Accessibility

Time pickers: Overview

Time pickers: Specs

Time pickers: Guidelines

Time pickers: Accessibility

Dialogs: Overview

Dialogs: Specs

Dialogs: Guidelines

Dialogs: Accessibility

Divider: Overview

Divider: Specs

Divider: Guidelines

Divider: Accessibility

Lists: Overview

Lists: Specs

Lists: Guidelines

Lists: Accessibility

Loading & progress

Loading indicator: Overview

Loading indicator: Specs

Loading indicator: Guidelines

Loading indicator: Accessibility

Progress indicators: Overview

Progress indicators: Specs

Progress indicators: Guidelines

Progress indicators: Accessibility

Menus: Overview

Menus: Specs

Menus: Guidelines

Menus: Accessibility

Navigation

Navigation bar: Overview

Navigation bar: Specs

Navigation bar: Guidelines

Navigation bar: Accessibility

Navigation drawer: Overview

Navigation drawer: Specs

Navigation drawer: Guidelines

Navigation drawer: Accessibility

Navigation rail: Overview

Navigation rail: Specs

Navigation rail: Guidelines

Navigation rail: Accessibility

Radio button: Overview

Radio button: Specs

Radio button: Guidelines

Radio button: Accessibility

Search: Overview

Search: Specs

Search: Guidelines

Search: Accessibility

Sheets

Bottom sheets: Overview

Bottom sheets: Specs

Bottom sheets: Guidelines

Bottom sheets: Accessibility

Side sheets: Overview

Side sheets: Specs

Side sheets: Guidelines

Side sheets: Accessibility

Sliders: Overview

Sliders: Specs

Sliders: Guidelines

Sliders: Accessibility

Snackbar: Overview

Snackbar: Specs

Snackbar: Guidelines

Snackbar: Accessibility

Switch: Overview

Switch: Specs

Switch: Guidelines

Switch: Accessibility

Tabs: Overview

Tabs: Specs

Tabs: Guidelines

Tabs: Accessibility

Text fields: Overview

Text fields: Specs

Text fields: Guidelines

Text fields: Accessibility

Toolbars: Overview

Toolbars: Specs

Toolbars: Guidelines

Toolbars: Accessibility

Tooltips: Overview

Tooltips: Specs

Tooltips: Guidelines

Tooltips: Accessibility

On this page

Chips: Guidelines ​

Chips help people enter information, make selections, filter content, or trigger actions


4 chip variants: Assist, filter, input, and suggestion.
There are four variants of chips: Assist, filter, input, and suggestion

Usage ​

Chips help people enter information, make selections, filter content, or trigger actions. They're best used to help people accomplish their current task faster and easier.

3 assist chips in restaurant review app.
Chips appear as a group of interactive elements

Chips aren’t buttons

Chips and buttonsButtons let people take action and make choices with one tap.More on buttons are similar. They both provide visual cues to prompt people to take actions and make selections.

While buttons appear consistently and with familiar calls to action, chips are dynamic to the situation, and appear as a group of interactive elements.

Use chips to enhance a person's current journey and encourage action. Use buttons to progress them through the product and for significant actions.

Chips used for “Reserve a table” and “Order delivery” in a restaurant app.
Do Use chips to present contextual, supplemental options
Chips used for Save and Cancel actions in a dialog.
Don’t Avoid replacing major actions with chips. Actions that progress people to the next or previous step should always be displayed as buttons.

Chips should dynamically offer various actions depending on the current task, whereas a button should be a persistent fixture of a layout.

Chips represent forking paths for a current task, while buttons represent linear steps.

Button labeled “Save task” in a task management app.
Do Use buttons for the final step in a task
Chip labeled “Save task” in a task management app.
Don’t Avoid using chips to finish or progress a task

Multiple chips should appear together in a set, whereas there should be no more than 3 buttons in a single arrangement.

Chip sets can be scrolled horizontally.

Multiple chips in event reminder.
Do Chips can be scrolled horizontally
Single chip in event reminder.
Don’t Don’t display a single chip by itself. Chips should appear in a set.

Variants

Choose the chip variant based on its purpose and author.

Does the chip represent an action (assist chip) or filter results (filter chip)?

Is its content generated by the product (suggestion chip), or by the person using the product (input chip)?

4 chip variants.

There are four chip variants:

  1. Assist
  2. Filter
  3. Input
  4. Suggestion
PurposeChip variantRationaleExample
ActionAssist chipAssist chips represent smart or automated actions that can span multiple appsAdd to calendar action
FilterFilter chipFilter chips represent filters for a collectionPlatform selector on material.io/components
Information, user-authoredInput chipInput chips represent discrete pieces of information entered by a personGmail contact in the To field
Information, product-authoredSuggestion chipSuggestion chips help narrow a person’s intent by presenting dynamically-generated suggestionsSuggested chat response

Anatomy ​

Diagram of 4 elements of a chip.
  1. Container
  2. Label text
  3. Leading icon or image (optional)
  4. Trailing icon (required for input chips, optional for filter chips)

Container

All chips are slightly rounded with an 8dp corner.

Diagram of rounded corner of chip container.
Chips have rounded corners

Shadows & elevation

Chip containers can be elevated if placed on top of an image or dynamic background.

3 elevated assist chips above image of restaurant photograph.
When on complicated backgrounds, chip containers can be elevated
3 variants of chips in an outlined style.
Do Use an outline to define the edge of the chip's container on regular backgrounds
3 variants of chips in an elevated style above restaurant photograph.
Do Chips may use elevation when placed on an image
4 elevated chips above blank background.
Don’t Chips shouldn't be elevated when placed directly on the page
Elevated chip in pressed state.
Don’t Avoid using elevation to indicate a chip's pressed state. Instead, use the visual ripple effect.

Label text

Chip label text should be 20 characters or fewer, and have the same typography style as buttonsButtons let people take action and make choices with one tap.More on buttons.

Chip labels should remain brief for the limited space available. Skip conventional grammar rules, such as articles (take "a" walk), to save space.

Filter chip in maps app labeled “Walking.”
Do Keep chip labels short
Filter chip in maps app labeled “Walking navigation session.
Don’t Avoid chip labels longer than 20 characters

Leading icon or image (optional)

Chips can contain a leading icon, logo, or circular image. Use a system icon to help identify a chip's category.

2 input chips, 1 with a leading circular avatar and the other with a leading icon.
Chips can contain a logo, icon, or circular image

The leading icon color for unselected chips can be customized through theming. While the default color roleColor roles are assigned to UI elements based on emphasis, container type, and relationship with other elements. This ensures proper contrast and usage in any color scheme.More on color roles is primary, the on surface variant color role is a good alternative when the icon style requires less emphasis.

2 screens of a restaurant page with chips labeled "Add photos" and "Add dishes." The leading icons are purple in 1, grey in the other.
Primary color (left) and on surface variant color (right)

Leading circular images are sized larger than leading icons to provide more space for detail. Icons are designed to be legible at small sizes.

See the Specs tab for precise measurement values.

2 input chips, 1 with a 24dp leading avatar and the other with an 18dp leading icon.
Leading images, such as avatars, are sized larger than leading icons or logos

Trailing icon (optional, input and filter chips only)

The trailing icon is present for input and filter chipsFilter chips use tags or descriptive words to filter content. They can be a good alternative to toggle buttons or checkboxes..

On input chips, it's required and must be used to remove the chip. On filter chips, it's optional, and can be used to open a menu or remove the chip.

Secondary actions (such as a trailing icon button for Remove) must have a 48x48dp interaction target that doesn’t interfere with the chip's primary action (such as Edit or Drag). To achieve this, apply a minimum width of 88dp to the chip, or 42dp to the label text.

A chip with 88dp min width has 2 touch targets of 48x48dp.
Interaction targets for actions like Edit or Close have a size of 48x48. This can be achieved by setting the minimum container width to 88dp.

Assist chips ​

Assist chips represent smart or automated actions that can span multiple apps, such as opening a calendar event from the home screen. Assist chips function as though the person asked an assistant to complete the action. They should appear dynamically and contextually in a UI.

An alternative to assist chips are buttonsButtons let people take action and make choices with one tap.More on buttons, which should appear persistently and consistently.

2 assist chips labeled “Add to my itinerary” and “12 mins from hotel” on map screen about Los Cantantes.
The text in most assist chips begins with a short verb, like Get or Add
2 assist chips labeled “Event location” and “Chat” on phone lock screen.
An assist chip can surface supplemental information like a calendar event, as well as provide contextual actions
Assist chip transformed into time picker with radio buttons.
During an interaction, assist chips can transform into modals, transition into full-screen views of new content, or readjust to display more results inline

Assist chips can trigger an action or show progress and confirmation.

Write assist chips like buttons: start with a verb. Adjust text dynamically if the state changes, like Save to Saved.

Tapping an assist chip triggers a contextual action
Assist chips can show progress and confirmation feedback

Assist chips are displayed after primary content, such as below a cardCards display content and actions about a single subject.More on cards or persistently at the bottom of a screen.

3 assist chips labeled “Turn on lights”, “Set alarm”, and "Close Blinds" on Welcome Home screen.
Assist chips should be shown underneath primary content

Filter chips ​

Filter chips use tags or descriptive words to filter content. They can be a good alternative to segmented buttonsSegmented buttons help people select options, switch views, or sort elements.More on segmented buttons or checkboxesCheckboxes let users select one or more items from a list, or turn an item on or off.More on checkboxes when viewing a list or search results.

Tapping on a filter chip activates it and appends a leading checkmark icon to the starting edge of the chip label.

Write filter chips with nouns that describe the category to include in the results. Avoid negative phrases like Exclude images.

4 filter chips labeled “Docs” “Slides” “Sheets” and “Images” with “Slides” and “Sheets” selected
Filter chips rely on tags or descriptive words to filter content
5 filter chips representing popular electronics categories in a shopping app. The chip “Game consoles” is selected.
Filter chips in a shopping app
6 filter chips representing apartment amenities in a real estate app. 2 of the chips are selected.
Filter chips in a real estate app

Tap a chip to select it. Multiple chips can be selected or unselected.

6 filter chips representing apartment amenities in a real estate app. 3 selected chips include checkmarks while 3 don’t.
An icon can be added to indicate when a filter chip is selected
3 amenities chips are selected, and 2 neighborhoods.
Filter chip suggestions can dynamically change as a person starts to select filters

Alternatively, a single chip can be selected. This offers an alternative to segmented buttonsSegmented buttons help people select options, switch views, or sort elements.More on segmented buttons, radio buttonsRadio buttons let people select one option from a set of options.More on radio buttons, or single select menusMenus display a list of choices on a temporary surface.More on menus.

However, avoid mixing chip set behaviors. All chip sets on a page should be either single-select or multi-select.

Filter chips can be set so that selecting a single chip automatically deselects all other chips in the set

In mediumWindow widths from 600dp to 839dp, such as a tablet or foldable in portrait orientation.More on medium breakpoints and expanded breakpointsWindow widths 840dp to 1199dp, such as a tablet or foldable in landscape orientation, or desktop.More on expanded breakpoints, filter chips may contain a trailing icon to directly remove the chip or open a menu of options.

In compact windowsWindow widths smaller than 600dp, such as a phone in portrait orientation.More on compact breakpoints, the trailing icon's target area is too small to be accessible on its own. However, if the whole chip can be selected to accomplish the action, the chip is likely still accessible.

Filter chip with trailing remove icon.
The remove icon helps users remove the filter
Filter chip with trailing menu icon.
Filter chips can open a menu for more filtering options

When combined with a menuMenus display a list of choices on a temporary surface.More on menus, the filter chip opens a list of selectable options.

Caution In compact windows, make sure the whole chip opens the menu. Otherwise, the target area is likely too small to be accessible.

Filter chips can be used with other components, such as searchSearch lets people enter a keyword or phrase to get relevant information.More on search fields and sheetsSide sheets show secondary content anchored to the side of the screen.More on side sheets.

4 filter chips below search field
Filter chips can be shown underneath a search field
Filter chips used as tags in a side sheet on a file application.
Use a side sheet to organize many filter chips
6 filter chips wrapping to 2 rows
Filter chips can wrap to a new row. If there are more than two rows, consider using horizontal scrolling to access them all.
4 filter chips with right-most chip partly offscreen, indicating the chips are horizontally scrollable
Filter chips can scroll horizontally to show many options
Single filter chip option beneath the header “Category”
Don’t Filter chips should not present only a single option

Input chips ​

Input chips represent discrete pieces of information entered by a person, such as Gmail contacts or filter options within a searchSearch lets people enter a keyword or phrase to get relevant information.More on search field.

They enable user input and verify that input by converting text into chips.

Contacts transformed into 2 input chips in a draft event invite
Input chips transform text based on a person's input

Input chips can support editing to change their contents, such as correcting an email address. In edit mode, the chip reverts back to a text string. Editing can be triggered by interacting with the chip, either by selecting it or by a second interaction after selection.

Input chips converted from email addresses are editable
Using the backspace key with the cursor before a chip selects the entire chip. The chip can then be deleted when the user taps the backspace key again.

A single field can contain multiple input chipsInput chips represent discrete pieces of information entered by a user, such as Gmail contacts or filter options within a search field.. These chips can be reordered or moved into other fields.

2 input chips in the “To” field of an email draft
Multiple input chips in one field
1 input chip moved from the “To” field to the “CC” field of an email draft
Input chips being moved from one field to another

Input chips can expand to show more information or options. A container transform transition pattern is used to reveal additional content.

Input chips can expand

Placement

Input chips can be integrated with other components.

They can appear:

  • Inline with the cursor in a text field
  • In a stacked list
  • In a list that can be horizontally scrolled
4 input chips wrapping to 2 rows.
Input chips can wrap to a new row if all chips need to be visible
Input chips can scroll horizontally

Icons & images

The leading icon of input chips can be an icon, logo, or circular image.

2 input chips, 1 with leading thumbnail, 1 with leading icon.
Input chips can contain an icon, logo, or circular image

The trailing icon is always aligned to the end side of the container. It’s placed:

  • On the right for left-to-right (LTR) languages, such as English
  • On the left for right-to-left (RTL) languages, such as Farsi
2 input chips with trailing icons following the label text.
Input chips can be a more flexible way to filter search results, compared to filter chips
3 input chips with trailing icons following the label text.
Input chips make it easier to add and remove contacts
Overflowed chips in a text field should follow the same behavior as regular text. An unfocused text field with overflowed content should display the beginning of the input. Tapping the field snaps the user to the end of the input with the cursor and keyboard active.

Suggestion chips ​

Suggestion chips help narrow a user’s intent by presenting dynamically generated suggestions, such as possible responses or search filters.

Write suggestion chips as nouns or short phrases, depending on context. Avoid exceeding 20 characters when possible.

3 suggestion chips offering ID options in a photo-recognition app.
The text labels within suggestion chips are most often nouns or short phrases
3 suggestion chips with automated reply options in a chat app.
Suggestion chips can offer quick-reply options in a chat or email app
2 suggestion chips with search options “What song is this?” and “What are the lyrics?”
A suggestion chip can help the user start a search

Placement ​

When displaying multiple chips together, place them inline as a row of options, not listed vertically. Overflowing chips should break to the next line.

If the field is only one row high, chip sets can scroll horizontally instead.

Keep an 8dp minimum space between chips. Chips must also have a minimum 48dp target size, regardless of placement or density. If required, the target can extend beyond the visible container of the chip.

Text labels for chips should be concise. Chip labels will truncate when in a wrapped layout, and when they are wider than the full width of the window.

Diagram of margins between a set of chips.
  1. Margins between chips
  2. Margin between each line
Pager
Previous pageChips: Specs
Next pageChips: Accessibility

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google

https://m3.material.io/components/chips/guidelines

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google