TableActionCell

Components/Lists/Table

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

Overview

Copy

Table action cell is a built-in solution that displays actions inside of table cells. The primary action is displayed as a button, while secondary actions are displayed either as multiple icon buttons or listed in a popover menu. Component should be rendered in the last column of a data row.

Do

  • Use it to display actions that a user can take on a specific table row.
  • Render it in the last column of a table row.
  • Group similar items together using dividers in popover menu for easy readability.

Don't

  • Don't use it to display single or multiple actions directly on a page or a widget. Use standard <Button/> instead.

Feature examples

Size

Control the size of primary and secondary actions displayed in a table cell with the size prop. Component supports 2 sizes:

  • medium - use in all common cases
  • small - use for dense tables
Copy

Primary action

Define a main action of a cell with the primaryAction prop. Action will be revealed on table row hover only.

Copy

Primary action visibility

Control the appearance of a primary action with the visibility prop. It supports 2 options:

  • onHover (default) - button is only visible when the mouse hovers over item.
  • always - button is always visible and appears as a secondary button.
Copy

Primary action icon affix

Give more context to the primary action by adding an icon affix. It can be added to 2 locations:

  • prefixIcon - use to add a descriptive icon in front of a label
  • suffixIcon - use to add a directional icon at the end of a label
Copy

Secondary actions

Define an array of additional actions for each row with the secondaryActions prop. Icon and text label are required to be specified. Actions will be listed in a popover menu.

Add the label for an icon button that opens up a popover menu using moreActionsTooltipText. Recommended label text: 'More actions'. It will be shown in a tooltip on hover or focus.

Copy

Number of visible secondary actions

Display a selected number of secondary actions as icon buttons with the numOfVisibleSecondaryActions prop. By default actions will be revealed on hover only.

To display the icons all the time use the alwaysShowSecondaryActions prop.

Copy

Divider

Add a separating line to group related actions or distinguish destructive actions from the rest. Do it in a popover menu by rendering divider as a separate action in the secondaryActions array.

Copy

Disabled

Disable all interactions for primary or secondary actions with the disabled prop. Use it to highlight unavailable functions.

Always provide an explanation for the user why actions cannot be accessed. Use disabledDescription prop to show a descriptive message in a tooltip.

Note: at the moment description can be added to visible secondary actions only.

Copy

Popover menu

Customize the appearance of secondary actions popover menu with popoverMenuProps.

Check <PopoverMenu/> API for a full list of available properties.

Copy

Common use case examples

Row actions

Use table action cell to display row actions in the last column of a data table.

Copy

Groups

Use dividers to group large lists of actions in a secondary actions menu.

Copy

Code

Copy

Props

NameTypeDefaultDescription
alwaysShowPrimaryActionsboolean—Specifies whether primary actions should be visible all the time. By default primary actions are visible on row hover only.
alwaysShowSecondaryActionsboolean—Specifies whether secondary actions should be visible all the time. By default secondary actions are visible on row hover only.
dataHookstring—Applies a data-hook HTML attribute to be used in the tests.
moreActionsPropsTableActionCellMoreActionsProps—Controls the appearance of the more actions icon button.
moreActionsTooltipTextstring—Sets the tooltip text of more actions icon button.
numOfVisibleSecondaryActionsnumber—Specifies the number of secondary actions to display outside of the popover menu.
onClick() => void—Called when clicking on the table action cell.
popoverMenuPropsTableActionCellPopoverMenuProps—Controls the appearance of secondary actions menu with all common popover menu props.
primaryActionButtonHTMLAttributes<HTMLButtonElement> & { visibility?: TableActionCellPrimaryActionVisibility | undefined; } & { ...; } & BaseActionProps | AnchorHTMLAttributes<HTMLAnchorElement> & { visibility?: TableActionCellPrimaryActionVisibility | undefined; } & { ...; } & BaseActionProps | { visibility?: TableActionCellPrimaryActionVisibility | undefined; } & { [additionalProps: string]: any; as: "object" | "abbr" | "address" | ... 106 more ... | "wbr"; onClick?: MouseEventHandler<...> | undefined; } & BaseActionProps | { visibility?: TableActionCellPrimaryActionVisibility | undefined; } & { [additionalProps: string]: any; as: ComponentType<any>; onClick?: MouseEventHandler<...> | undefined; } & BaseActionProps | TableActionCellMainAction[]—Controls the behaviour and appearance of a primary action. Can be a single action object or an array of action objects.
primaryActionPlaceholderPropsTableActionCellPrimaryActionPlaceholderProps—Controls the appearance of the primary action placeholder icon button.
secondaryActions(TableActionCellSecondaryAction | TableActionCellSecondaryDivider)[]—Controls the behaviour and appearance of secondary actions.
secondaryActionsPropsTableActionCellSecondaryActionsProps—Controls the appearance of the visible inline secondary action icon buttons.
size"small" | "tiny" | "medium"mediumControls the size of action buttons.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
getPrimaryActionButtonDriverGet the driver of the primary action
getPrimaryActionButtonDriverByDataHookGet the driver of a specific primary action
getPrimaryActionsCountGet the number of primary actions (for array format)
getPrimaryActionButtonVisibilityGets primary action visibility value
clickPrimaryActionButtonClicks the primary action button of the action column
clickPrimaryActionClicks a specific primary action button by index (for array format)
clickPrimaryActionByDataHookClicks a specific primary action button by dataHook (for array format)
getIsPrimaryActionButtonDisabledChecks whether the primary action button is disabled
primaryActionButtonPrefixIconExistsChecks whether the primary action button has an prefix icon
primaryActionButtonSuffixIconExistsChecks whether the primary action button has an suffix icon
getVisibleActionsCountGet the number of the visible secondary actions
getHiddenActionsCountGet the number of hidden secondary actions (in the , requires it to be open)
getVisibleActionTooltipDriverGets a specific visible secondary action driver
getVisibleActionByDataHookTooltipDriverGet the driver of a specific visible secondary action by its specified dataHook
getVisibleActionButtonDriverGet the driver of a specific visible secondary action
getVisibleActionByDataHookButtonDriverGets a specific visible secondary action
getHiddenActionsPopoverMenuDriverGets the hidden secondary action driver
clickVisibleActionClicks on a visible secondary action
clickVisibleActionByDataHookClicks on a visible secondary action by its specified dataHook
clickPopoverMenuClicks on the hidden secondary actions
clickHiddenActionClicks on a hidden secondary action (requires the to be open)
clickHiddenActionByDataHookClicks hidden action by data hook
getMoreActionsTooltipTextGets tooltip text of more actions toggle button
existsChecks whether the component found with the given data hook.
elementGets the component root element.
clickClicks on the component root element.
baseReturns UniDriver for the base element.

Changelog

  • 1.342.0 (2026-10-26) — maintenance release, no component-specific changes
  • 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.331.0 (2026-10-01) — maintenance release, no component-specific changes
  • 1.330.3 (2026-09-29) — fix: row actions are now always visible when WixDesignSystemProvider has mobile enabled, including inside Table, where touch users previously couldn't reveal them. Desktop behavior is unchanged. (#17265) — has visual 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.321.0 (2026-09-08) — feat: added primaryActionPlaceholderProps prop, letting you control the priority of the primary action's placeholder icon button. (#17020) — has visual changes
  • 1.313.1 (2026-08-18) — fix: in Harmony (odeditor) and Studio 2.0 (odeditor-dark), row content that reaches the actions now fades into a backdrop that matches the row's background (including its hover fill) just before the first visible action instead of running under the buttons, and items in the "more actions" popover menu hover grey like other PopoverMenu items. (#16780) — has visual changes
  • 1.310.0 (2026-08-10) — maintenance release, no component-specific changes
  • 1.306.0 (2026-07-31) — maintenance release, no component-specific changes
  • 1.299.0 (2026-07-17) — breaking: reduce gap between action buttons (Harmony & Harmony Dark themes) (#16564) — has visual 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.284.0 (2026-06-04) — feat: add secondaryActionsProps to override visible action priority (#16334) — has visual changes
  • 1.280.0 (2026-05-19) — feat: forward click event to secondary action onClick (#16279)
  • 1.280.0 (2026-05-19) — fix: respect size prop in cell height (#16268) — has visual changes
  • 1.278.0 (2026-05-08) — maintenance release, no component-specific changes
  • 1.277.0 (2026-05-07) — maintenance release, no component-specific changes
  • 1.266.0 (2026-04-07) — maintenance release, no component-specific changes
  • 1.260.0 (2026-03-17) — maintenance release, no component-specific changes
  • 1.247.2 (2026-01-21) — maintenance release, no component-specific changes
  • 1.242.0 (2025-12-19) — maintenance release, no component-specific changes
  • 1.222.0 (2025-10-23) — feat: add moreActionsProps to allow skin and priority control of IconButton (#15428)
  • 1.220.0 (2025-09-29) — feat: primaryAction can be array with different priorities (#15338)
  • 1.204.0 (2025-07-03) — feat: add premium skin to primary and secondary actions (#15035)
  • 1.204.0 (2025-07-03) — fix: disabled tooltip not showing (#15044)
  • 1.180.0 (2025-04-14) — maintenance release, no component-specific changes
  • 1.172.0 (2025-03-20) — fix: return missing dataHook (#14630)
  • 1.172.0 (2025-03-20) — fix: fix broken import of data hooks (#14624)
  • 1.171.0 (2025-03-14) — feat: add disabled primary action tooltip for table list item action cell (#14609)
  • 1.154.0 (2025-01-17) — maintenance release, no component-specific changes
  • 1.122.0 (2024-08-21) — fix: missing focus ring when keyboard navigating (#14042)
  • 1.115.0 (2024-07-17) — maintenance release, no component-specific changes
  • 1.104.0 (2024-05-06) — fix: revert "feat(TableActionCell): add background gradient (#13654)" (#13700)
  • 1.103.4 (2024-05-02) — fix: sticky cell will be always visible (#13662)
  • 1.103.3 (2024-04-30) — feat: add background gradient (#13654)
  • 1.102.0 (2024-04-16) — maintenance release, no component-specific changes
  • 1.98.0 (2024-03-15) — maintenance release, no component-specific changes
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 26 October 2026

Did this help?