Components/Lists/Table
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/tableactioncell
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.
<Button/> instead.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 casessmall - use for dense tablesDefine a main action of a cell with the primaryAction prop. Action will be revealed on table row hover only.
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.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 labelsuffixIcon - use to add a directional icon at the end of a labelDefine 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.
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.
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.
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.
Customize the appearance of secondary actions popover menu with popoverMenuProps.
Check <PopoverMenu/> API for a full list of available properties.
Use table action cell to display row actions in the last column of a data table.
Use dividers to group large lists of actions in a secondary actions menu.
| Name | Type | Default | Description |
|---|---|---|---|
alwaysShowPrimaryActions | boolean | — | Specifies whether primary actions should be visible all the time. By default primary actions are visible on row hover only. |
alwaysShowSecondaryActions | boolean | — | Specifies whether secondary actions should be visible all the time. By default secondary actions are visible on row hover only. |
dataHook | string | — | Applies a data-hook HTML attribute to be used in the tests. |
moreActionsProps | TableActionCellMoreActionsProps | — | Controls the appearance of the more actions icon button. |
moreActionsTooltipText | string | — | Sets the tooltip text of more actions icon button. |
numOfVisibleSecondaryActions | number | — | Specifies the number of secondary actions to display outside of the popover menu. |
onClick | () => void | — | Called when clicking on the table action cell. |
popoverMenuProps | TableActionCellPopoverMenuProps | — | Controls the appearance of secondary actions menu with all common popover menu props. |
primaryAction | ButtonHTMLAttributes<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. |
primaryActionPlaceholderProps | TableActionCellPrimaryActionPlaceholderProps | — | Controls the appearance of the primary action placeholder icon button. |
secondaryActions | (TableActionCellSecondaryAction | TableActionCellSecondaryDivider)[] | — | Controls the behaviour and appearance of secondary actions. |
secondaryActionsProps | TableActionCellSecondaryActionsProps | — | Controls the appearance of the visible inline secondary action icon buttons. |
size | "small" | "tiny" | "medium" | medium | Controls the size of action buttons. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
getPrimaryActionButtonDriver | Get the driver of the primary action |
getPrimaryActionButtonDriverByDataHook | Get the driver of a specific primary action |
getPrimaryActionsCount | Get the number of primary actions (for array format) |
getPrimaryActionButtonVisibility | Gets primary action visibility value |
clickPrimaryActionButton | Clicks the primary action button of the action column |
clickPrimaryAction | Clicks a specific primary action button by index (for array format) |
clickPrimaryActionByDataHook | Clicks a specific primary action button by dataHook (for array format) |
getIsPrimaryActionButtonDisabled | Checks whether the primary action button is disabled |
primaryActionButtonPrefixIconExists | Checks whether the primary action button has an prefix icon |
primaryActionButtonSuffixIconExists | Checks whether the primary action button has an suffix icon |
getVisibleActionsCount | Get the number of the visible secondary actions |
getHiddenActionsCount | Get the number of hidden secondary actions (in the |
getVisibleActionTooltipDriver | Gets a specific visible secondary action |
getVisibleActionByDataHookTooltipDriver | Get the driver of a specific visible secondary action |
getVisibleActionButtonDriver | Get the driver of a specific visible secondary action |
getVisibleActionByDataHookButtonDriver | Gets a specific visible secondary action |
getHiddenActionsPopoverMenuDriver | Gets the hidden secondary action |
clickVisibleAction | Clicks on a visible secondary action |
clickVisibleActionByDataHook | Clicks on a visible secondary action by its specified dataHook |
clickPopoverMenu | Clicks on the hidden secondary actions |
clickHiddenAction | Clicks on a hidden secondary action (requires the |
clickHiddenActionByDataHook | Clicks hidden action by data hook |
getMoreActionsTooltipText | Gets tooltip text of more actions toggle button |
exists | Checks whether the component found with the given data hook. |
element | Gets the component root element. |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
WixDesignSystemProvider has mobile enabled, including inside Table, where touch users previously couldn't reveal them. Desktop behavior is unchanged. (#17265) — has visual changesprimaryActionPlaceholderProps prop, letting you control the priority of the primary action's placeholder icon button. (#17020) — has visual changesmoreActionsProps to allow skin and priority control of IconButton (#15428)Last updated: 26 October 2026