Interactive Example
Rules of Thumb
- Use Segmented Buttons:
- To filter a Grid or Table.
- To switch a view’s display mode.
- One option must always be selected.
Appearance and Behavior
To learn more about adding Help Text to Segmented Buttons, see the Forms and Validation guidance.
Examples
![Do: Use Segmented Buttons to filter an associated table or grid.](/img/components/segmented-button/segmented-button-do-1.webp)
![Don’t: Use Segmented Buttons to switch between separate views. Use Tabs instead.](/img/components/segmented-button/segmented-button-dont-1.webp)
![Do: Use Segmented Buttons to switch a view’s display mode.](/img/components/segmented-button/segmented-button-do-2.webp)
![Don’t: Use Segmented Buttons for user input in a form. Use Radio Buttons or Select Menus instead.](/img/components/segmented-button/segmented-button-dont-2.webp)
Asset Status
Asset | Version | Status |
---|---|---|
Documentation | N/A | Available |
UI Kit - Dark | v7 | Available |
UI Kit - Light | v7 | Available |
UI Kit - Wireframe | v7 | Available |
Web Component | v7 | Available |
Component Tokens | N/A | Planned |
Status Key
AvailableIn ProgressPlannedNot AvailableDeprecated