Components/Lists
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/selectableaccordion
Selectable accordion is a list of interactive items, which show and collapse additional content when they are selected and deselected.
<Collapse/> mechanism instead.<Checkbox/> or <ToggleSwitch/> instead.Selectable accordion consists of clickable items and their inner content, which is expanded when an item is selected.
Inner content areas accept any components inside.
Give an item tooltipContent to wrap it in a tooltip. Its main use is explaining why an item is disabled, so people are not left guessing why they cannot select it.
Say what would make the option available rather than restating that it is unavailable.
Change the type of items' controller with type prop. It supports 2 options:
checkbox - use when multiple items can be selected at once.toggle - use when items (or features) are enabled / disabled.Control vertical padding of selectable accordion items with verticalPadding prop:
medium is a larger padding that emphasizes a few items.small (default) is a standard padding for common cases.tiny is a compact padding that displays more items in a smaller space.Note that verticalPadding prop only controls the padding of selectable accordion items (and not their inner content).
Describe selectable accordion items with title and subtitle props.
These containers also accept any component or a composition of multiple elements.
By default, all selectable accordion items are closed until selected by the user.
Control which items are open on page load with initiallyOpen prop.
Disable a selectable accordion item with disabled prop.
Users will not be able to select or deselect it.
Control the selectable accordion items programatically using open prop.
A selectable accordion on a settings page helps save space and reduces mental load for the user.
This is because the UI displays only the settings that are relevant at a time.
| Name | Type | Default | Description |
|---|---|---|---|
ariaLabel | string | — | Sets an accessible name for the radio group. Applied only when type is 'radio'. |
ariaLabelledby | string | — | Sets the id of the element that labels the radio group. Applied only when type is 'radio'. |
dataHook | string | — | Applied as data-hook HTML attribute that can be used in the tests. |
items | SelectableAccordionItemProps[] | — | An array of Accordion items: - title: A title of the item - subtitle: An optional second row of the header - content: A content of the item - initiallyOpen: Whether the item is initially open - open: Whether the item is open - disabled: Whether the item is disabled - tooltipContent: Content of a tooltip shown when hovering over the item (e.g. to explain a disabled item) - onClick: A callback which is invoked when item's selection is changed |
onSelectionChanged | (selectedIds: number[]) => void | — | A callback which is invoked every time the selection is changed. |
type | "checkbox" | "radio" | "toggle" | 'radio' | A type can be ether radio, checkbox, or toggle, which affects the way an accordion item is selected. |
verticalPadding | "small" | "tiny" | "medium" | — | Extra space on top and bottom of selectable accordion item. |
No testkit for this component — it doesn't expose a unidriver testkit.
type="radio" the items now form a real radio group. The root has role="radiogroup" and takes new ariaLabel / ariaLabelledby props, each radio is named by its item title, arrow keys move between items, and focus lands on the selected radio. (#17029)tooltipContent prop that shows a tooltip on hover, useful for explaining why an item is disabled. Disabled items now match Accordion's disabled appearance, with the background and label greyed out. (#16880) — has visual changesLast updated: 22 October 2026