TextButton

Components/Actions

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

Overview

Copy

Text buttons communicate low-emphasis actions that users can take.

Do

  • Use it for optional actions on a page or a widget.
  • Use it to navigate to another page.
  • Use it to display a large list of optional actions.

Don't

  • Don't use it for primary or submit actions. Use a regular <Button/> instead.

Feature examples

Size

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.
Copy

Skin

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.
Copy

Affix

Add more context to actions with affix icons:

  • Emphasize the button action with a prefixIcon.
  • Indicate that an action will open a popover or navigate users to another page with a suffixIcon.
Copy

Underline

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.
Copy

Disabled

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

Copy

Text overflow

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.

Copy

Full width

Set the button to fill 100% of its parent container width with the fluid prop. Use this setting for mobile designs only.

Copy

Weight

Control button boldness with weight prop. It supports three different weights, that are based on <Text/> component.

Copy

Developer examples

Custom HTML tag

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.

Copy

Common use case examples

Settings panel

Use text buttons for optional actions, such as links to help center articles.

Copy

List of actions

Use a dark skin for a list of actions to avoid distracting or overwhelming the user.

Copy

Accessibility examples

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:

  • Select a contrasting link color, such as standard text button next to dark text.
  • Use text button underline.
  • Or use a fitting 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'.

Copy

Use text button underline and ExternalLink icon to emphasize text buttons that open up a link in a new tab.

Copy

Code

Copy

Props

NameTypeDefaultDescription
ariaActiveDescendantstring—Identifies the element that represents the currently active descendant of the button.
ariaControlsstring—Identifies the element whose contents or presence are controlled by the button.
ariaExpandedboolean—Indicates to screen reader users whether the collapsible content below is in the expanded or in the collapsed state.
ariaHaspopupstring—Indicates to screen reader users whether an interactive popup element, such as menu or dialog, can be triggered by a button.
ariaLabelstring—Defines a string value that labels the button element to screen reader users.
ariaLabelledBystring—Identifies the element that labels the button element.
as"button"—Renders component as any other component or a given HTML tag.
childrenReactNode—Accepts any item as a child element. For all common cases pass a standard text string.
dataHookstring—Applies a data-hook HTML attribute that can be used in the tests.
disabledboolean—Specifies whether user interactions are disabled.
ellipsisboolean—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.
fluidboolean—Stretches button to fill a 100% of its parent container width.
onClickMouseEventHandler—Defines a callback function which is called every time a button is clicked.
prefixIconReactElement—Pass an icon or a component to display at the front of a label (e.g., svg, image, etc.)
refnull | 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).
showTooltipboolean—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.
suffixIconReactElement—Pass an icon or a component to display at the end of a label (e.g., svg, image, etc.)
tooltipPropsTooltipCommonProps—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.
wrapfalse—Enables wrapping when text is longer than its parent container. Cannot be used with as="button"

Testkit

Import the driver matching your test environment:

Copy

Driver methods

Method definitions couldn't be extracted for this driver.

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.3 (2026-09-29) — maintenance release, no component-specific changes
  • 1.330.0 (2026-09-28) — maintenance release, no component-specific changes
  • 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.323.0 (2026-09-10) — maintenance release, no component-specific changes
  • 1.320.0 (2026-09-03) — fix: labels and button heights are one step smaller at every size in Harmony (odeditor), matching the Business Manager spec. All other themes are unchanged. (#16951) — has visual 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.289.0 (2026-06-17) — maintenance release, no component-specific changes
  • 1.273.0 (2026-04-30) — maintenance release, no component-specific changes
  • 1.266.0 (2026-04-07) — maintenance release, no component-specific changes
  • 1.232.0 (2025-11-28) — maintenance release, no component-specific changes
  • 1.213.0 (2025-08-19) — maintenance release, no component-specific changes
  • 1.212.0 (2025-08-11) — maintenance release, no component-specific changes
  • 1.191.1 (2025-05-27) — maintenance release, no component-specific changes
  • 1.165.0 (2025-02-27) — maintenance release, no component-specific changes
  • 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
  • 1.127.0 (2024-09-12) — fix: moving mobile styles up to reduce specificity (#14117)
  • 1.120.1 (2024-08-08) — maintenance release, no component-specific changes
  • 1.120.0 (2024-08-02) — maintenance release, no component-specific changes
  • 1.115.0 (2024-07-17) — feat: wrap (#13940)
  • 1.110.0 (2024-06-20) — feat: add standard-light theme (#13860)
  • 1.107.0 (2024-05-29) — maintenance release, no component-specific changes
  • 1.104.1 (2024-05-14) — maintenance release, no component-specific changes
  • 1.103.3 (2024-04-30) — maintenance release, no component-specific changes
  • 1.102.0 (2024-04-16) — maintenance release, no component-specific changes
  • 1.99.0 (2024-03-29) — feat: add bold weight and mobile design (#13499)
  • 1.93.0 (2024-02-08) — maintenance release, no component-specific changes
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 22 October 2026

Did this help?