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

Tabs: Guidelines ​

Tabs organize content across different screens and views

Usage ​

Tabs organize groups of related content that are at the same level of hierarchy.

Mobile screen with 3 tabs: video, photos and audio. Each tab has an an icon and text.
Tab labels can include icons and text. Text labels should be short.

There are two variants of tabs:

  1. Primary tabs
  2. Secondary tabs

Primary tabs are placed at the top of the content panePanes are layout containers that house other components and elements within a single app. A pane can be: fixed, flexible, floating, or semi permanent.More on panes under an app barApp bars display information and actions at the top of a screen.More on app bars. They display the main content destinations.

Secondary tabs are used within a content area to further separate related content and establish hierarchy.

3 primary tabs above 3 secondary tabs.
  1. Primary tabs
  2. Secondary tabs

Related content

Use tabs to group related content, not sequential content.

Scrolling up and down through content, then swiping left through tabs.
Do Utilize tabs to categorize related groups of content into clearly defined sets
Mobile screen with scrollable tabs of sequential content: Chapter 1, Chapter 2, Chapter 3 and Chapter 4.
Don't Don't use tabs to move through sequential content that needs to be read in a particular order. Instead, create hierarchy within the content using techniques like typography style and open space.

Anatomy ​

Six components of tabs.
  1. Container
  2. Icon (optional)
  3. Badge (optional)
  4. Label
  5. Divider
  6. Active indicator

Container

The container holds multiple tabs. Its contents can be fixed or scrollable.

The container should always extend the full width of the window and be divided into equal sections, one for each tab.

The container is defined by a dividerDividers are thin lines that group content in lists or other containers.More on dividers on the bottom edge to separate it from the content below. Content may scroll under the container.

Mobile screen with fixed tabs with a dotted border to illustrate the container area.
The container is the area that contains the tabs directly under the title above

Icon (optional)

Icons communicate the kind of content within a tab. Icons should be simple and recognizable.

Mobile screen with tabs that use both icons and labels.
Tabs can use a combination of labels and icons

Icons alone aren't as effective as text labels at communicating complex content.

Use caution when representing tab content with icons alone, as an icon's meaning may not be clear.

Mobile screen with tabs represented by icons for "wishlist" and "location".
Do Use icons that are globally recognized when using icons alone
Mobile screen where "purchases" tab has text only and "wishlist" tab has text and icon.
Don't Don't use tabs with both icons and text labels on only some tabs, but not others

Label

Text labels should clearly and succinctly describe the content within the tab.

Tab labels appear in a single row. Labels can use a second line if needed, with truncated text. Alternatively, scrollable tabs can allow room for longer titles.

Mobile screen with scrollable tabs in a single row.
Tab labels should be short and succinct. There should be a clear relationship to the title above.

When using scrollable tabs, the first visible tab should be offset by 52dp from the left side of the device for both web and mobile. The width of each tab is defined by the length of its text label.

Avoid using inconsistent padding on each tab.

Screen with scrollable tabs offset from the leading edge by 52dp.
Do Offset the first scrollable tab 52dp from the leading edge so it's clear that more content is available
Screen with scrollable tabs, 2 of which are truncated to "Australian" showing how truncation can confuse users.
Don't Don't truncate labels unless required, as truncated text can impede comprehension

Badges (optional)

BadgesBadges show notifications, counts, or status information on navigation items and icons.More on badges can be used on primary or secondary tabs to show notifications or updates related to a specific tab. Limit badge content to four characters, including a "+".

Once the user views the relevant content in the tab, the badge value should update or the badge should disappear entirely.

Small and large badges can both be used with tabs. Read the badge guidance for more details.

Mobile screen with tabs that use both icons and labels.
Badges are used to highlight notifications related to tab specific content

Active indicator

To differentiate an active tab from an inactive tab, apply an underline and color change to the active tab's text and icon.

An underline and color change differentiate an active tab from the inactive ones

Choosing the tab variant ​

Primary tabsPrimary tabs display an app's main content destinations. They're are placed at the top of the screen, often under a top app bar. should be used when just one set of tabs are needed.

Secondary tabsSecondary tabs display related content within a content area. They're always placed below primary tabs. are necessary when a screen requires more than one level of tabs. These tabs use a simpler style of indicator, but their function is identical to primary tabs.

Mobile screen with primary tabs near the top of the screen.
Tabs can be joined with components like app bars, embedded in a specific UI region, or nested within components like cards and sheets. Tabs control the UI region displayed below them.

Placement ​

Tabs are displayed in a single row, with each tab connected to the content it represents. As a set, all tabs are unified by a shared topic.

Secondary tabsSecondary tabs display related content within a content area. They're always placed below primary tabs. should always be placed below primary tabsPrimary tabs display an app's main content destinations. They're are placed at the top of the screen, often under a top app bar..

Mobile screen with secondary tabs below the primary tabs.
Secondary tabs are found within other content to assist users with greater detail

Responsive layout ​

For fixed tabs, the maximum width for each tab should be determined by the width of the widest tab. The group of tabs should use a fluid marginMargins are the spaces between the edge of a nested element and its parent element, such as the space between a button's label text and the edge of its container.More on margins and align to the center or leading edge of the body region.

Avoid using more than four tabs at once. At five or more tabs, the container becomes cramped.

Four fixed tabs spaced to match one another.
Tabs can grow in width in relation to the number of items contained within

Behavior ​

States

By default, tabs inherit enabledAn enabled state communicates an interactive component or element.More on enabled state statesStates show the interaction status of a component or UI element.More on states with one active state. The inactive and active states of a tab can inherit a hoverA hover state communicates when a user has placed a cursor above an interactive element.More on hover state, focusA focused state communicates when a user has highlighted an element, using an input method such as a keyboard or voice.More on focused state, and pressedA pressed state communicates a user tap.More on pressed state states.

Four states of a tab.
Active, hover, focused, and pressed states

Fixed tabs

Fixed tabs display all tabs in a set simultaneously. They are best for switching between related content quickly, such as between transportation methods in a map. To navigate between fixed tabs, tap an individual tab, or swipe left or right in the content area.

Fixed tabs allow users to see all possible kinds of content available

Tap a tab

Navigate to a tab by tapping on it.

Tapping on a tab directly

Swipe within the content area

To navigate between tabs, users can swipe left or right within the content area.

Users can swipe between fixed tabs to see related content quickly

Use caution when placing other swipeable content (such as interactive maps or listLists are continuous, vertical indexes of text and images.More on lists items) in the content area.

Do Use different gesture directions when using tabs
Don't Avoid placing swipeable items in the content area of a UI that has tabs, as the user may mistakenly swipe the wrong component

Scrollable tabs

When a set of tabs cannot fit on screen, use scrollable tabs. Scrollable tabs can use longer text labels and a larger number of tabs. They are best used for browsing on touch interfaces.

Padding should remain the same when using scrolllable tabs and long labels

Scrolling content

When a screen scrolls up and down through content, tabs can either be fixed to the top of the screen, or scroll off the screen. If they scroll off the screen, they will return when the user scrolls upward.

Tabs can be use to create elevation

Do Tabs can scroll offscreen on scroll, and reappear when the page is scrolled up
Don't Don't scroll tabs behind an app bar. When tabs are attached to a component, they should appear and move as a single unit.
Pager
Previous pageTabs: Specs
Next pageTabs: Accessibility

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google

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

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google