SplitAction

Components/Actions

Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/splitaction

Overview

Copy

Split action combines a primary action or a set of actions with a secondary menu of related actions.

Do

  • Use it to communicate a primary action alongside related alternative actions.
  • Limit visible actions to 2–3, place additional options in the dropdown.
  • Group actions that belong to the same task (e.g. different ways to publish).

Don't

  • Don't hide commonly used actions in the dropdown, use separate buttons instead.
  • Don't duplicate actions between the main buttons and the dropdown.
  • Don't use vague labels like "More" or "Actions" for visible buttons.
  • Don't use it as a replacement for navigation or links, use <Tabs/>, <Breadcrumbs/> or <Pagination/> instead.

Feature examples

Size

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.

Copy

Skin

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.

Copy

Affix

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.

Copy

Grouping

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.

Copy

Disabled

To disable a split button, use the disabled prop which indicates a button can't be selected.

Copy

Text overflow

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.

Copy

Developer examples

Styling

Properties are applied through a parent <SplitAction/> container and they control all child elements within a group.

Copy

Common use case examples

Composer

Use <SplitAction/> in composer headers to pair a primary CTA with additional overflow actions e.g. schedule, save as draft, duplicate.

Copy

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.

Copy

Card

Use <SplitAction/> on content cards to surface a primary action alongside secondary options e.g. duplicate, cancel, without overcrowding the row.

Copy

Code

Copy

Props

NameTypeDefaultDescription
childrenReactNode—Children: SplitActionButton and SplitActionIconButton.
classNamestring—Specifies a CSS class name to be appended to the component's root element.
dataHookstring—Applies a data-hook HTML attribute that can be used in the tests.
disabledboolean—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.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
exists—
getButtonCountGets the number of buttons
getButtonReturns the driver for the button at the given index
elementGets the component root element.
clickClicks on the component root element.
baseReturns UniDriver for the base element.

Changelog

  • 1.340.0 (2026-10-21) — maintenance release, no component-specific changes
  • 1.339.0 (2026-10-19) — maintenance release, no component-specific changes
  • 1.338.0 (2026-10-15) — maintenance release, no component-specific changes
  • 1.330.0 (2026-09-28) — maintenance release, no component-specific changes
  • 1.329.0 (2026-09-24) — maintenance release, no component-specific changes
  • 1.328.0 (2026-09-22) — maintenance release, no component-specific changes
  • 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.310.0 (2026-08-10) — maintenance release, no component-specific changes
  • 1.292.0 (2026-06-22) — maintenance release, no component-specific changes
  • 1.291.0 (2026-06-19) — maintenance release, no component-specific changes
  • 1.275.0 (2026-05-04) — maintenance release, no component-specific changes
  • 1.266.0 (2026-04-07) — fix: instead of gap, added divider as per spec (#16069) — has visual changes

Last updated: 22 October 2026

Did this help?