> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: TextButton Component

## Article: TextButton Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/actions/text-button-component.md

## Article Content:

# TextButton

_Components/Actions_

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

## Overview

```jsx
<Box direction="vertical" align="center">
  <TextButton prefixIcon={<Icons.Add />}>Add Category</TextButton>
</Box>;
```

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.

```jsx
<StorybookComponents.Stack flexDirection="column" gap="60px">
  <TextButton size="medium">Medium</TextButton>
  <TextButton size="small">Small</TextButton>
  <TextButton size="tiny">Tiny</TextButton>
</StorybookComponents.Stack>;
```

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

```jsx
<StorybookComponents.Stack flexDirection="column" gap="60px">
  <TextButton skin="standard">Standard</TextButton>
  <TextButton skin="destructive">Destructive</TextButton>
  <StorybookComponents.Background skin="dark">
    <TextButton skin="standard-light">Standard Light</TextButton>
  </StorybookComponents.Background>
  <StorybookComponents.Background skin="dark">
    <TextButton skin="light">Light</TextButton>
  </StorybookComponents.Background>
  <TextButton skin="premium">Premium</TextButton>
  <TextButton skin="dark">Dark</TextButton>
</StorybookComponents.Stack>;
```

#### 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`.

```jsx
<StorybookComponents.Stack flexDirection="column" gap="60px">
  <StorybookComponents.Stack>
    <TextButton size="medium" prefixIcon={<Icons.Add />}>
      Prefix
    </TextButton>
    <TextButton size="medium" suffixIcon={<Icons.ChevronDown />}>
      Suffix
    </TextButton>
  </StorybookComponents.Stack>
  <StorybookComponents.Stack>
    <TextButton size="small" prefixIcon={<Icons.AddSmall />}>
      Prefix
    </TextButton>
    <TextButton size="small" suffixIcon={<Icons.ChevronDownSmall />}>
      Suffix
    </TextButton>
  </StorybookComponents.Stack>
  <StorybookComponents.Stack>
    <TextButton size="tiny" prefixIcon={<Icons.AddSmall />}>
      Prefix
    </TextButton>
    <TextButton size="tiny" suffixIcon={<Icons.ChevronDownSmall />}>
      Suffix
    </TextButton>
  </StorybookComponents.Stack>
</StorybookComponents.Stack>;
```

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

```jsx
<StorybookComponents.Stack flexDirection="column" gap="60px">
  <TextButton>None</TextButton>
  <TextButton underline="onHover">On Hover</TextButton>
  <TextButton underline="always">Always</TextButton>
</StorybookComponents.Stack>;
```

#### Disabled

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

```jsx
<TextButton disabled>Disabled</TextButton>;
```

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

```jsx
<StorybookComponents.Stack flexDirection="column" width="360px">
  <TextButton ellipsis>
    This label exceeds available space and is shown in a tooltip
  </TextButton>
</StorybookComponents.Stack>;
```

#### Full width

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

```jsx
<TextButton fluid>Full Width</TextButton>;
```

#### Weight

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

```jsx
<StorybookComponents.Stack flexDirection="column" gap="12px">
  <TextButton weight="bold" size="medium">
    Bold
  </TextButton>
  <TextButton weight="normal" size="medium">
    Normal
  </TextButton>
  <TextButton weight="thin" size="medium">
    Thin
  </TextButton>
</StorybookComponents.Stack>;
```

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

```jsx
() => {
  const ReactRouterLink = (props) => <div {...props} />;
  return (
    <StorybookComponents.Stack flexDirection="column">
      <TextButton as="a" href="https://www.wix.com" target="_blank">
        {'Native <a/> tag'}
      </TextButton>
      <TextButton as={ReactRouterLink} skin="premium" to="/home">
        {'React Router <Link/> tag'}
      </TextButton>
      <TextButton as="button">{'Native <button/> tag'}</TextButton>
    </StorybookComponents.Stack>
  );
};
```

### Common use case examples

#### Settings panel

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

```jsx
<SidePanel
  skin="floating"
  width="420px"
  onCloseButtonClick={() => {}}
  onHelpButtonClick={() => {}}
>
  <SidePanel.Header title="Booking Calendar" />
  <Box height="480px">
    <VerticalTabs size="small" activeTabId={5} onChange={() => {}}>
      <VerticalTabs.TabItem id={0}>Manage</VerticalTabs.TabItem>
      <VerticalTabs.TabItem id={1}>Layout</VerticalTabs.TabItem>
      <VerticalTabs.TabItem id={2}>Display</VerticalTabs.TabItem>
      <VerticalTabs.TabItem id={3}>Design</VerticalTabs.TabItem>
      <VerticalTabs.TabItem id={4}>Text</VerticalTabs.TabItem>
      <VerticalTabs.TabItem id={5}>Support</VerticalTabs.TabItem>
    </VerticalTabs>
    <Divider direction="vertical" />
    <SidePanel.Content noPadding>
      <SidePanel.Field>
        <section>
          <Text size="small" secondary>
            Frequently asked questions
          </Text>
          <Box gap={2} direction="vertical" paddingTop={2}>
            <TextButton
              size="small"
              suffixIcon={<Icons.ExternalLinkSmall />}
              ellipsis
            >
              Customize calendar page
            </TextButton>
            <TextButton
              size="small"
              suffixIcon={<Icons.ExternalLinkSmall />}
              ellipsis
            >
              Time zone display
            </TextButton>
            <TextButton
              size="small"
              suffixIcon={<Icons.ExternalLinkSmall />}
              ellipsis
            >
              Appointment time slots
            </TextButton>
            <TextButton
              size="small"
              suffixIcon={<Icons.ExternalLinkSmall />}
              ellipsis
            >
              Date and time formatting
            </TextButton>
            <TextButton
              size="small"
              suffixIcon={<Icons.ExternalLinkSmall />}
              ellipsis
            >
              How-to articles
            </TextButton>
          </Box>
        </section>
      </SidePanel.Field>
      <SidePanel.Field>
        <section>
          <Text size="small" secondary>
            Still having issues?
          </Text>
          <Box gap={2} direction="vertical" paddingTop={2}>
            <TextButton
              size="small"
              prefixIcon={<Icons.ChatSmall />}
              suffixIcon={<Icons.ExternalLinkSmall />}
              ellipsis
            >
              Contact customer care
            </TextButton>
          </Box>
        </section>
      </SidePanel.Field>
    </SidePanel.Content>
  </Box>
</SidePanel>;
```

#### List of actions

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

```jsx
<Layout>
  <Cell span={6}>
    <Card>
      <Card.Header title="Promote" />
      <Card.Divider />
      <Card.Content>
        <Box direction="vertical" gap="18px">
          <TextButton skin="dark" prefixIcon={<Icons.Coupon />}>
            Create Coupon
          </TextButton>
          <TextButton skin="dark" prefixIcon={<Icons.VideoCamera />}>
            Create Promo Video
          </TextButton>
          <TextButton skin="dark" prefixIcon={<Icons.EmailSend />}>
            Send Email Campaign
          </TextButton>
          <TextButton skin="dark" prefixIcon={<Icons.Share />}>
            Share Product
          </TextButton>
          <TextButton skin="dark" prefixIcon={<Icons.Settings />}>
            Edit SEO Settings
          </TextButton>
        </Box>
      </Card.Content>
    </Card>
  </Cell>
</Layout>;
```

### Accessibility examples

#### Inline links

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

```jsx
<Page>
  <Page.Header
    title="Subscriptions"
    subtitle={
      <Box gap="SP1">
        <Text secondary>
          Manage all recurring payments from Pricing Plans, Stores & Invoices.
        </Text>
        <TextButton underline="always">
          Learn more about Subscriptions
        </TextButton>
      </Box>
    }
    actionsBar={<Button prefixIcon={<Icons.Add />}>Sell Pricing Plan</Button>}
  />
  <Page.Content>
    <StorybookComponents.Placeholder>
      <Box verticalAlign="middle" align="center" height="60px">
        <Text>Page content</Text>
      </Box>
    </StorybookComponents.Placeholder>
  </Page.Content>
</Page>;
```

#### External links

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

```jsx
<Card>
  <MarketingLayout
    title="Create an email campaign"
    description={
      <Text size="small" secondary>
        Send updates, offers or newsletters and keep in touch with your
        customers.
        <Box inline>
          <TextButton
            size="small"
            underline="always"
            suffixIcon={<Icons.ExternalLinkSmall />}
          >
            Learn more about email campaigns
          </TextButton>
        </Box>
      </Text>
    }
    actions={<Button size="small">Create Campaign</Button>}
    size="tiny"
    hiddenBadge
    alignItems="stretch"
    image={
      <Box width="100%" align="right">
        <Image
          width="120px"
          src="PromotionalPromoteMarketingHomeEmail.svg"
          transparent
        />
      </Box>
    }
  />
</Card>;
```

## Code

```jsx
import { TextButton } from '@wix/design-system';
```

### Props

| 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" |

## Testkit

Import the driver matching your test environment:

```jsx
// UniDriver
import { TextButtonUniDriver } from '@wix/design-system/dist/testkit/unidriver';

// Vanilla
import { TextButtonTestkit } from '@wix/design-system/dist/testkit';

// Puppeteer
import { TextButtonTestkit } from '@wix/design-system/dist/testkit/puppeteer';

// Testing Library
import { TextButtonTestkit } from '@wix/design-system/dist/testkit/testing-library';
```

### 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](invalid-url)) — 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](invalid-url))
- **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](invalid-url))
- **1.110.0** (2024-06-20) — feat: add standard-light theme ([#13860](invalid-url))
- **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](invalid-url))
- **1.93.0** (2024-02-08) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes