Skip to main content
v1.0.0 | View in Storybook

When to use

  • To toggle between related views or data sets, like switching between “List view” and “Grid view”.
  • To filter content by category, such as “All”, “Private”, “Public”.
  • When you want to provide quick, mutually exclusive choices that immediately affect the display without navigating away.
  • When the options are closely related and equal in hierarchy.
  • For primary view switches.

When to use something else

  • Options need longer descriptions or aren’t a tight filter set: use Radio.
  • Larger content sections or page-scale switching: use Tabs.
  • Binary on/off: use Switch.
  • Mutually exclusive actions (not views): use Toolbar or Toggle group as appropriate.
  • More than ~five options or multi-select: use Select, Combobox, or Tree view.

Dos and don’ts

  • Do pre-select a default option that is most common or aligns with the primary task.
  • Do be consistent in icon and label usage. If using a leading icon for one control, use them for all.
  • Do keep the options between 2-5 so as not to overwhelm the user.
  • Don’t use Segmented control for unrelated actions.
  • Don’t mix icon-only with label-only.
  • Don’t use Segmented control to trigger actions like “Save” or “Delete”.

Often used with

The content region it toggles (e.g. list vs grid); Tooltip if any segment is icon-only.

Visual examples

The examples below are interactive and follow the doc site’s theming: light mode when the docs site is in light mode, and dark mode when you switch the docs site to dark mode.

Size variants

Choose the size that matches surrounding controls—use smaller segments in dense toolbars or side panels, and larger segments when the control is a primary view switch.

Tab content variants

Use label-only, icon-only, or icon-and-label segments consistently within a group so users can scan options quickly without mixed visual patterns.

Controlled

Use a controlled segmented control when the selected segment must follow application logic—for example, syncing with URL state, a parent form, or programmatic updates.

Disabled tabs

Disable individual segments when an option is temporarily unavailable, and add a tooltip or helper text that explains why that view or filter cannot be selected.

Slide animation

Use the slide animation when switching between segments should feel fluid—for example, toggling between related views where motion reinforces the connection between options.

Full width

Use full-width layout when the segmented control spans its container—for example, in a side panel or when two to three options should share equal space across the available width.
Last modified on September 16, 2026