Components/Actions
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/iconbutton
Icon buttons highlight actions that users can take, used in compact or crowded layouts.
<Tooltip/>.<Button/> or <TextButton/> instead.Update the dimensions of a button with the size prop.
large is for onboarding flows and marketing pages where the action needs more emphasis.medium is the default for all common cases.small is for icon buttons used in cards and widgets.tiny is for small and dense layouts.Note: small and tiny size buttons should use the small icon size (18x18).
Change the button's appearance with the skin prop.
standard is the default for all general actions.light is for dark backgrounds.transparent is for backgrounds with colors or images.premium is for actions that prompt users to upgrade their plans.dark should be used with buttons on backgrounds with colors.ai should be used with AI based features.Each action can be primary, secondary or tertiary, depending on priority. 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.
To disable a button, use the disabled prop which indicates a button can't be selected.
Render buttons as any given HTML tag with the as prop. For example, they can be rendered as:
<a> when attributes like href, target are needed.<Link> when props like to, replace, etc. are needed.All attributes will be passed to the rendered element.
Use <Tooltip/> to add a label to icon buttons.
Use icon buttons in small and crowded layouts.
Use icon buttons to open a <PopoverMenu/>.
Use icon buttons for lower-priority actions that have no effect on the main user flow. For example, to change the cover image of an audio.
| Name | Type | Default | Description |
|---|---|---|---|
ariaLabel | string | — | Define a string value that labels the button element. |
ariaLabelledBy | string | — | Identify the element that labels the button element. |
as | "button" | — | Renders component as any other component or a given HTML tag. |
dataHook | string | — | Applies a data-hook HTML attribute that can be used in the tests. |
disabled | boolean | — | Specify whether button should be disabled. |
onClick | MouseEventHandler | — | Defines a callback function which is called every time a button is clicked. |
priority | "primary" | "secondary" | "tertiary" | — | Control the priority of a component. |
ref | null | string | (instance: IconButtonHandle | null) => void | RefObject<IconButtonHandle> | — | Allows getting a ref to the component instance. Once the component unmounts, React will set ref.current to null (or call the ref with null if you passed a callback ref). |
size | "small" | "tiny" | "medium" | "large" | — | Control the size of a component. |
skin | "standard" | "light" | "inverted" | "destructive" | "premium" | "dark" | "transparent" | "ai" | — | Sets the skin of a component. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
isButtonDisabled | returns true if button disabled |
isFocused | Checks whether button is focused |
hasSize | Checks whether the resolved rendered size matches the given size, including provider defaults |
hasSkin | Checks whether the resolved rendered skin matches the given skin, including provider defaults |
hasPriority | Checks whether the resolved rendered priority matches the given priority, including provider defaults |
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. |
skin="dark" with priority="secondary" has a transparent background in Harmony (odeditor) and Studio 2.0 Light (studio2-light). (#17295) — has visual changesLast updated: 30 October 2026