Design System v1.0

Select

Choose one or more options from a dropdown list.

Single value

A single-value select styled to match the design system.

Grouped sites

A styled select with options organized into groups.

With placeholder

A select showing a placeholder until a value is chosen.

Option groups

A custom select with labelled option groups.

Multiple with placeholder

A multi-select that accepts several values at once.

Multiple with preset values

A multi-select pre-populated with selected values and inline tags.

Clothing
Footwear

Inspired by shadcn/ui expressions

API reference

Choose one value from a list. A Root holds the value and wraps a Trigger plus a portalled, positioned Content of Items.

Full props on Base UI Select
Anatomy
SelectRoot. Owns the value state and wraps the trigger and content.
SelectContentThe popup listbox — portalled, positioned below the trigger.
SelectGroupWraps related items. Required around a SelectLabel.
SelectItemA selectable option; shows a check when selected.
SelectLabelA non-interactive heading for a group. Must be inside SelectGroup.
SelectScrollDownButtonScroll-down affordance shown when the list overflows.
SelectScrollUpButtonScroll-up affordance shown when the list overflows.
SelectSeparatorA thin divider between groups or items.
SelectTriggerThe button that opens the listbox and shows the current value.
SelectValueRenders the selected item's label, or the placeholder when empty.
Props
PartPropTypeDefaultDescription
SelectTriggersize"sm" | "default""default"Control height — sm (h-7) or default (h-8).
SelectContentside"top" | "bottom" | "left" | "right""bottom"Which side of the trigger the popup opens on.
SelectContentalign"start" | "center" | "end""start"Alignment of the popup relative to the trigger.
SelectContentsideOffsetnumber4Gap in pixels between the trigger and the popup.
SelectContentalignItemWithTriggerbooleanfalsemacOS-style overlay of the selected item onto the trigger. Off, for standard dropdown positioning.

Command Palette

Search for a command to run...