Components/Actions
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/splitaction
Split action combines a primary action or a set of actions with a secondary menu of related actions.
<Tabs/>, <Breadcrumbs/> or <Pagination/> instead.Control button size with size prop:
large is best for calls to action that require more emphasis.
medium is for main page actions and common use cases.
small fits into smaller UI elements like cards and widgets.
tiny is used for dense layouts.
Change the appearance of a button with a skin prop.
standard is for general primary actions.
light is for primary actions that are on dark backgrounds.
dark should be used with buttons on backgrounds with colors.
transparent is for general actions on backgrounds with vivid colors or images.
premium is for actions that prompt users to upgrade their plans to premium subscription.
Each action can be primary or secondary. There should only be one primary action per page.
Note: Secondary buttons should be used alongside primary buttons for less utilized actions, such as cancel or back.
Add more context to actions with affix icons:
Emphasize the button action with a prefixIcon.
Note: Avoid using a suffixIcon, especially chevrons or directional indicators. These can be confused with the split icon button's dropdown trigger and make the interaction unclear.
Place up to 2–3 visible actions inside the <SplitAction/> group, and move the rest under the chevron icon button.
Note: Limiting visible actions keeps the primary decision clear and UI uncluttered. If you need more than three visible actions, consider whether a full toolbar pattern fits better or use separate buttons.
To disable a split button, use the disabled prop which indicates a button can't be selected.
Use the ellipsis prop for overflow text. The full text will be displayed in a <Tooltip/> when a user hovers over the button. Control the style of the tooltip using the tooltipProps.
Note: Try to avoid lengthy action labels. CTA text should be short and clear – one to two words, or max three for specific use cases.
Properties are applied through a parent <SplitAction/> container and they control all child elements within a group.
Use <SplitAction/> in composer headers to pair a primary CTA with additional overflow actions e.g. schedule, save as draft, duplicate.
Use <SplitAction/> in modal footers to pair a primary CTA with additional overflow actions e.g. save & add another, save as draft, save as template.
Use <SplitAction/> on content cards to surface a primary action alongside secondary options e.g. duplicate, cancel, without overcrowding the row.
| Name | Type | Default | Description |
|---|---|---|---|
children | ReactNode | — | Children: SplitActionButton and SplitActionIconButton. |
className | string | — | Specifies a CSS class name to be appended to the component's root element. |
dataHook | string | — | Applies a data-hook HTML attribute that can be used in the tests. |
disabled | boolean | — | Specifies whether user interactions are disabled. Applied to all children. |
priority | "primary" | "secondary" | "tertiary" | — | Specifies the priority. Applied to all children. |
size | "small" | "tiny" | "medium" | "large" | — | Controls the size. Applied to all children. |
skin | "standard" | "light" | "inverted" | "premium" | "dark" | "transparent" | — | Specifies the skin. Applied to all children. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
exists | — |
getButtonCount | Gets the number of buttons |
getButton | Returns the driver for the button at the given index |
element | Gets the component root element. |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
Last updated: 22 October 2026