SocialButton

Components/Actions

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

Overview

Copy

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.

Copy

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
Copy

Disabled

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

Copy

Common use case examples

Sharing

Use <AnnouncementModalLayout/> to give enough open space to promote social sharing with <SocialButton/> actions, that are larger and more prominent than regular buttons.

Copy

Code

Copy

Props

NameTypeDefaultDescription
dataHookstring—Applies a data-hook HTML attribute that can be used in the tests.
disabledboolean—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.
onClickEventHandler<MouseEvent<HTMLElement, MouseEvent>>—Defines a callback function which is called when the button is clicked.
textReactNode—Text for the button.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
getTextGets buttons text value
existsChecks whether the component found with the given data hook.
elementGets the component root element.
clickClicks on the component root element.
baseReturns 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) — 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

Last updated: 22 October 2026

Did this help?