···11+---
22+title: Segmented Control
33+description: A segmented control displays a set of mutually exclusive options, allowing users to select one option at a time.
44+---
55+66+import { PropDocs } from '../../lib/PropDocs'
77+import { Example } from '../../lib/Example'
88+import { Basic } from '../../examples/segmented-control/basic'
99+import { Size } from '../../examples/segmented-control/size'
1010+import { WithIcons } from '../../examples/segmented-control/with-icons'
1111+1212+<Example src={Basic} />
1313+1414+## Installation
1515+1616+Run the following command to add the segmented control component to your project.
1717+1818+```bash
1919+pnpm hip install segmented-control
2020+```
2121+2222+## Props
2323+2424+This component is built using [React Aria ToggleButtonGroup](https://react-spectrum.adobe.com/react-aria/ToggleButtonGroup.html).
2525+2626+<PropDocs components={["SegmentedControl", "SegmentedControlItem"]} />
2727+2828+## Features
2929+3030+### Sizes
3131+3232+Segmented controls support three different sizes: small, medium, and large.
3333+3434+<Example src={Size} />
3535+3636+### With Icons
3737+3838+Segmented control items can include icons alongside text labels.
3939+4040+<Example src={WithIcons} />
4141+4242+## Related Components
4343+4444+- [Tabs](/docs/components/tabs) - For organizing content into multiple sections
4545+- [ToggleButtonGroup](/docs/components/toggle-button-group) - For grouping toggle buttons together
4646+- [Radio](/docs/components/radio) - For single-selection from multiple options
4747+