> 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: SocialButton Component

## Article: SocialButton Component

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

## Article Content:

# SocialButton

_Components/Actions_

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

## Overview

```jsx
<Box align="center">
  <SocialButton text="Share on Facebook" icon="facebook" />
</Box>;
```

Social button allow users to share content or follow social media channels.

### Do

- Use it to encourage users to share content.

### Don't

- Don't use it to navigate or modify the content. Use `<IconButton/>` instead.
- Don't use it as a static indicator. Use General Icons instead.

### Feature examples

#### Text

Give users additional explanation by using `text` prop to show label under the button.

```jsx
<StorybookComponents.Stack>
  <SocialButton text="Share on Facebook" icon="facebook" />
  <SocialButton icon="facebook" />
</StorybookComponents.Stack>;
```

#### Icon

Theme component to match social networks by using the icon prop with one of the following themes.

- `facebook`
- `twitter`
- `linkedIn`
- `instagram`
- `pinterest`
- `youtube`
- `xcorp`

```jsx
<StorybookComponents.Stack>
  <SocialButton icon="facebook" />
  <SocialButton icon="twitter" />
  <SocialButton icon="linkedin" />
  <SocialButton icon="instagram" />
  <SocialButton icon="pinterest" />
  <SocialButton icon="youtube" />
  <SocialButton icon="xcorp" />
</StorybookComponents.Stack>;
```

#### Disabled

Indicate that action is available but can not be performed at the moment by using `disabled` property.

```jsx
<StorybookComponents.Stack>
  <SocialButton icon="facebook" disabled />
  <SocialButton icon="twitter" disabled />
  <SocialButton icon="linkedin" disabled />
  <SocialButton icon="instagram" disabled />
  <SocialButton icon="pinterest" disabled />
  <SocialButton icon="youtube" disabled />
  <SocialButton icon="xcorp" disabled />
</StorybookComponents.Stack>;
```

### Common use case examples

#### Sharing

Use [`<AnnouncementModalLayout/>`](https://wix-pages.com/design-system-documentation/#/component/announcementmodallayout) to give enough open space to promote social sharing with [`<SocialButton/>`](https://wix-pages.com/design-system-documentation/#/component/socialbutton) actions, that are larger and more prominent than regular buttons.

```jsx
<AnnouncementModalLayout
  title="Share Your Campaign"
  onCloseButtonClick={() => {}}
>
  <Box direction="vertical" gap="40px" margin="3px">
    <Text>
      Give more people interacting with your campaign by sharing it on your
      social networks.
    </Text>
    <Box align="space-between" verticalAlign="middle">
      <SocialButton text="Share on Facebook" icon="facebook" />
      <SocialButton text="Share on Twitter" icon="twitter" />
      <SocialButton text="Share on Pinterest" icon="pinterest" />
    </Box>
    <Box>
      <Divider />
    </Box>
    <FormField label="Campaign URL">
      <Input
        suffix={
          <Box verticalAlign="middle" marginRight="SP1">
            <TextButton size="small" prefixIcon={<Icons.DuplicateSmall />}>
              {'Copy'}
            </TextButton>
          </Box>
        }
      />
    </FormField>
  </Box>
</AnnouncementModalLayout>;
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in the tests. |
| `disabled` | `boolean` | — | Specifies whether the button is disabled. A disabled button doesn't call `onClick`. |
| `icon` | `"facebook" \| "instagram" \| "twitter" \| "linkedin" \| "pinterest" \| "youtube" \| "xcorp" \| "tiktok"` | — | Share button social network type. |
| `onClick` | `EventHandler<MouseEvent<HTMLElement, MouseEvent>>` | — | Defines a callback function which is called when the button is clicked. |
| `text` | `ReactNode` | — | Text for the button. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `getText` | Gets buttons text value |
| `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. |

## 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.337.0** (2026-10-14) — maintenance release, no component-specific changes
- **1.331.0** (2026-10-01) — maintenance release, no component-specific changes
- **1.330.0** (2026-09-28) — maintenance release, no component-specific changes
- **1.329.0** (2026-09-24) — 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.310.0** (2026-08-10) — maintenance release, no component-specific changes
- **1.295.0** (2026-07-03) — maintenance release, no component-specific changes
- **1.292.0** (2026-06-22) — maintenance release, no component-specific changes
- **1.287.0** (2026-06-10) — feat: add tiktok icon ([#16354](invalid-url)) — has visual 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.260.0** (2026-03-17) — maintenance release, no component-specific changes
- **1.247.2** (2026-01-21) — maintenance release, no component-specific changes
- **1.212.0** (2025-08-11) — maintenance release, no component-specific changes
- **1.115.0** (2024-07-17) — maintenance release, no component-specific changes
- **1.102.0** (2024-04-16) — maintenance release, no component-specific changes
- **1.93.0** (2024-02-08) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes