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

## Article: SocialPreview Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/media/browser-preview-widget/social-preview-component.md

## Article Content:

# SocialPreview

_Components/Media/Preview/SocialPreview_

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

## Overview

```jsx
<StorybookComponents.Stack
  flexDirection="column"
  width="40%"
  alignItems="flex-start"
  gap="0"
>
  <Text>Preview on Twitter</Text>
  <Tooltip
    fixed
    content={
      <Text light>
        It takes time for changes you make to show live on Twitter. You can also
        manually refresh them. <a>Find out how</a>
      </Text>
    }
  >
    <Text>
      <a>When will changes show live?</a>
    </Text>
  </Tooltip>
  <StorybookComponents.Stack padding="SP2 0 0 0" width="100%">
    <SocialPreview
      size="small"
      skin="twitter"
      title="Getting a grasp on adventure"
      description="Create a blog post subtitle that summarizes your post in a few short, punchy sentences and entices your audience to continue reading."
      previewUrl="www.wix.com"
      media={
        <Image
          src="running_man.png"
          width="100%"
          height="100%"
          borderRadius="11px 0 0 11px"
        />
      }
    />
  </StorybookComponents.Stack>
</StorybookComponents.Stack>;
```

Social Preview allows users to see what information will be displayed once the URL address is shared on social media platforms.

### Do

- Use it when the site owner needs to preview how page information will be displayed on social media.

### Don't

- Don't use it as any other kind of preview for user-generated content.
- Don't use it instead of the GooglePreview component.
- Don't use it as an image preview.

### Feature examples

#### Structure

Component consists of four areas: media, URL address, title, and description.

```jsx
<SocialPreview
  title="Title"
  description="Description"
  previewUrl="WWW.SITE-NAME.COM"
  media={<Image height="360px" borderRadius="0px" />}
/>;
```

#### Size

Choose the size of the preview from:  - \`large\` - use for a preview generated by common social media platforms.\
 - \`small\` - use as alternative size for the Twitter platform only.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SocialPreview
    title="Large Size"
    description="Description"
    previewUrl="www.site-name.com"
    media={<Image width="100%" height="360px" borderRadius="0px" />}
  />
  <SocialPreview
    size="small"
    skin="twitter"
    title="Small Size"
    description="Description"
    previewUrl="www.site-name.com"
    media={<Image width="100%" height="100%" borderRadius="11px 0 0 11px" />}
  />
</StorybookComponents.Stack>;
```

#### Skin

Render preview for different social media platforms:\
 - \`social\` - use for a preview generated by common social media platforms.\
 - \`twitter\` - use to display a specific preview for twitter social media platform only

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SocialPreview
    skin="social"
    title="Social Skin"
    description="Description"
    previewUrl="www.site-name.com"
    media={<Image width="100%" height="360px" borderRadius="0px" />}
  />
  <SocialPreview
    skin="twitter"
    title="Twitter Skin"
    description="Description"
    previewUrl="www.site-name.com"
    media={<Image width="100%" height="360px" borderRadius="11px 11px 0 0" />}
  />
</StorybookComponents.Stack>;
```

### Common use case examples

#### Blog Post Share

In combination with Inputs, Social Preview allows site owners to tailor their blog posts' appearance on social media.

```jsx
<Box direction="vertical" align="left">
  <Text>Preview on Twitter</Text>
  <Tooltip
    fixed
    content={
      <Text light>
        It takes time for changes you make to show live on Twitter. You can also
        manually refresh them. <a>Find out how</a>
      </Text>
    }
  >
    <Text>
      <a>When will changes show live?</a>
    </Text>
  </Tooltip>

  <Box padding="SP1 0 SP4 0" width="100%">
    <SocialPreview
      title="Now You Can Blog from Everywhere!"
      description="We’ve made it quick and convenient for you to manage your blog from anywhere. In this blog post we’ll share the ways you can post to your Wix Blog."
      previewUrl="YOUR-SITE-HERE.COM"
      media={
        <ImageViewer
          height="360px"
          width="100%"
          removeRoundedBorders
          imageUrl="TravelExample7.jpg"
        />
      }
    />
  </Box>

  <Box direction="vertical" width="100%" gap="SP5">
    <FormField label="Social title">
      <Input defaultValue="Now You Can Blog From Everywhere!" />
    </FormField>
    <FormField label="Social description">
      <InputArea
        rows={3}
        defaultValue="We’ve made it quick and convenient for you to manage your blog from anywhere. In this blog post we’ll share the ways you can post to your Wix Blog."
      />
    </FormField>
  </Box>
</Box>;
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in the tests. |
| `description` | `string` | — | A social post link description. |
| `media` | `ReactNode` | — | A slot to render a media item, most commonly the ImageViewer component. |
| `previewUrl` | `string` | — | A url representation of the social post link. |
| `size` | `"small" \| "large"` | `'large'` | Specifies the size of the preview. Size small works only in combination with twitter skin. |
| `skin` | `"twitter" \| "social"` | `'social'` | Changes the style of the preview. |
| `title` | `string` | — | A social post link title. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `getTitle` | Get SocialPreview title |
| `getPreviewUrl` | Get SocialPreview url |
| `getDescription` | Get SocialPreview description |
| `getSkin` | Get SocialPreview skin |
| `getSize` | Get SocialPreview size |
| `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.330.3** (2026-09-29) — maintenance release, no component-specific changes
- **1.328.0** (2026-09-22) — maintenance release, no component-specific changes
- **1.325.0** (2026-09-17) — maintenance release, no component-specific changes
- **1.324.0** (2026-09-14) — maintenance release, no component-specific 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.288.0** (2026-06-15) — 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.250.0** (2026-01-27) — maintenance release, no component-specific changes
- **1.102.0** (2024-04-16) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes