Components/Actions
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/textbutton
Text buttons communicate low-emphasis actions that users can take.
<Button/> instead.Control the size of a button with the size prop:
Medium is the default size for general actions.Small should be used for cards and widgets.Tiny is for dense layouts.Control the appearance of a button with skin prop:
Standard is the default for general actions.Destructive is for actions that have a destructive effect on user data, such as delete.Standard-light is for main actions placed on dark backgrounds.Light is for general actions placed on dark backgrounds.Premium is used for actions that prompt users to upgrade their plans.Dark is for a list of actions stacked in a single place, like quick links in the sidebar.Add more context to actions with affix icons:
prefixIcon.suffixIcon.Control underline visibility with underline prop:
none is the default.onHover shows an underline on mouse hover.always shows an underline at all times. It is most suitable for text links.To disable a button, use the disabled prop which indicates a button can't be selected.
Use an ellipsis prop for overflow text. The full text will be displayed when a user hovers over the button.
Note: Try to avoid lengthy action labels. CTA text should be short and clear – one to two words, or three max for specific use cases.
Set the button to fill 100% of its parent container width with the fluid prop. Use this setting for mobile designs only.
Control button boldness with weight prop. It supports three different weights, that are based on <Text/> component.
Render buttons as any given HTML tag with the as prop.
Render text buttons that are links as:
<a> when attributes like href, target, etc., are needed.<Link> when props like to, replace, etc. are needed.All attributes will be passed to the rendered HTML tag.
Use text buttons for optional actions, such as links to help center articles.
Use a dark skin for a list of actions to avoid distracting or overwhelming the user.
Users with visual impairments may have trouble distinguishing links from text, if no additional visual indicators are given. Make inline text links stand out for all users:
standard text button next to dark text.underline.prefixIcon or suffixIcon.Also, use meaningful link text that conveys its function independently of the surrounding content. For example, say 'Learn More about Automations' instead of 'Learn More'.
Use text button underline and ExternalLink icon to emphasize text buttons that open up a link in a new tab.
| Name | Type | Default | Description |
|---|---|---|---|
ariaActiveDescendant | string | — | Identifies the element that represents the currently active descendant of the button. |
ariaControls | string | — | Identifies the element whose contents or presence are controlled by the button. |
ariaExpanded | boolean | — | Indicates to screen reader users whether the collapsible content below is in the expanded or in the collapsed state. |
ariaHaspopup | string | — | Indicates to screen reader users whether an interactive popup element, such as menu or dialog, can be triggered by a button. |
ariaLabel | string | — | Defines a string value that labels the button element to screen reader users. |
ariaLabelledBy | string | — | Identifies the element that labels the button element. |
as | "button" | — | Renders component as any other component or a given HTML tag. |
children | ReactNode | — | Accepts any item as a child element. For all common cases pass a standard text string. |
dataHook | string | — | Applies a data-hook HTML attribute that can be used in the tests. |
disabled | boolean | — | Specifies whether user interactions are disabled. |
ellipsis | boolean | — | Specifies whether component handles text overflow with ellipsis. If enabled, a label that exceeds the available space is displayed inside a tooltip when the user hovers over the button. |
fluid | boolean | — | Stretches button to fill a 100% of its parent container width. |
onClick | MouseEventHandler | — | Defines a callback function which is called every time a button is clicked. |
prefixIcon | ReactElement | — | Pass an icon or a component to display at the front of a label (e.g., svg, image, etc.) |
ref | null | string | (instance: TextButton | null) => void | RefObject<TextButton> | — | 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). |
showTooltip | boolean | — | Specifies whether the full button label is displayed in a tooltip when label overflows available space. Behaviour is enabled by default. Set property value to false to show ellipsis without a tooltip. |
size | "small" | "tiny" | "medium" | — | Controls the size of a button. |
skin | "standard" | "light" | "destructive" | "premium" | "dark" | "standard-light" | — | Specifies the skin of a button. |
suffixIcon | ReactElement | — | Pass an icon or a component to display at the end of a label (e.g., svg, image, etc.) |
tooltipProps | TooltipCommonProps | — | Allows to pass all common tooltip props. Use it to customize a tooltip created from text ellipsis. |
underline | "none" | "always" | "onHover" | — | Specifies whether to display and when to display an underline below button label. |
weight | "bold" | "normal" | "thin" | — | Controls the font weight of button label. |
wrap | false | — | Enables wrapping when text is longer than its parent container. Cannot be used with as="button" |
Import the driver matching your test environment:
Method definitions couldn't be extracted for this driver.
Last updated: 22 October 2026