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

## Article: AnnouncementModalLayout Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/overlays/modal/announcement-modal-layout-component.md

## Article Content:

# AnnouncementModalLayout

_Components/Overlays/Modal/AnnouncementModalLayout_

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

## Overview

```jsx
() => {
  const [modalOpened, setModalOpened] = React.useState(false);
  const openModal = () => setModalOpened(true);
  const closeModal = () => setModalOpened(false);

  return (
    <Box>
      <Button onClick={openModal}>Open Announcement Modal</Button>
      <Modal isOpen={modalOpened} onRequestClose={closeModal} screen="desktop">
        <AnnouncementModalLayout
          skin="premium"
          illustration={'generic_upgrade.svg'}
          title="Start Accepting Online Payments"
          primaryButtonText="Upgrade"
          linkText="Learn more"
          onCloseButtonClick={closeModal}
          primaryButtonOnClick={closeModal}
          linkOnClick={closeModal}
        >
          <Text>
            Upgrade your site with a business and ecommerce premium plan to
            start accepting payments.
          </Text>
        </AnnouncementModalLayout>
      </Modal>
    </Box>
  );
};
```

Use this component inside a Modal component to display content in the AnnouncementModalLayout. You may place a title and/or a footer with actions relevant to the displayed content

### Do

- Keep the message concise and benefit-focused.
- Make it easy to dismiss.
- Include an illustration.

### Don't

- Don't use it for critical information or destructive actions. Use `<MessageModalLayout/>` instead.
- Don't use it for forms or other inputs. Use `<CustomModalLayout/>` instead.
- Don't overload it with multiple CTAs or complex content.

### Feature examples

#### Simple Usage

A simple example with compact preview

```jsx
<AnnouncementModalLayout
  illustration={'generic_post.svg'}
  title="Import Posts From WordPress"
  primaryButtonText="Start Now"
  linkText="Learn More"
  onCloseButtonClick={() => {}}
>
  <Text>
    Your public posts, images and videos will be copied and added to your Wix
    blog. Your site and current posts won't be affected.
  </Text>
</AnnouncementModalLayout>;
```

#### Secondary Button Example

With a Secondary Button action instead of the link.

```jsx
<AnnouncementModalLayout
  illustration={'generic_post.svg'}
  title="Import Posts From WordPress"
  primaryButtonText="Start Now"
  secondaryButtonText="Skip"
  onCloseButtonClick={() => {}}
>
  <Text>
    Your public posts, images and videos will be copied and added to your Wix
    blog. Your site and current posts won't be affected.
  </Text>
</AnnouncementModalLayout>;
```

#### No Illustration Example

```jsx
<AnnouncementModalLayout
  title="All Your Info In One Place"
  primaryButtonText="Leave"
  linkText="Learn More"
  onCloseButtonClick={() => {}}
>
  <Text>
    Meet your brand new General Info page.
    <br />
    We brought all your business information together here.
  </Text>
  <Box
    backgroundColor="grey"
    width="444px"
    height="210px"
    marginTop="18px"
    borderRadius="4px"
  />
</AnnouncementModalLayout>;
```

#### Footnote Example

The basic example with the addition of a footnote

```jsx
<AnnouncementModalLayout
  illustration={'generic_post.svg'}
  primaryButtonText="Start Now"
  linkText="Learn More"
  title="Import Posts From WordPress"
  onCloseButtonClick={() => {}}
  footnote={
    <Text size="small">
      By sending an invite, you agree to the <a>Wix Terms of Use</a>
    </Text>
  }
>
  <Text>
    Your public posts, images and videos will be copied and added to your Wix
    blog. Your site and current posts won't be affected.
  </Text>
</AnnouncementModalLayout>;
```

#### Skin Example

The basic example with a premium skin

```jsx
<AnnouncementModalLayout
  skin="premium"
  illustration={'generic_upgrade.svg'}
  title="Start Accepting Online Payments"
  primaryButtonText="Upgrade"
  linkText="Learn More"
  onCloseButtonClick={() => {}}
>
  <Text>
    Upgrade your site with a business and ecommerce premium plan to start
    accepting payments.
  </Text>
</AnnouncementModalLayout>;
```

#### Help Button Example

The basic example with a help button shown

```jsx
<AnnouncementModalLayout
  illustration={'generic_post.svg'}
  title="Import Posts From WordPress"
  primaryButtonText="Start Now"
  linkText="Learn More"
  onCloseButtonClick={() => {}}
  onHelpButtonClick={() => {}}
>
  <Text>
    Your public posts, images and videos will be copied and added to your Wix
    blog. Your site and current posts won't be affected.
  </Text>
</AnnouncementModalLayout>;
```

### Developer examples

#### Mobile usage

On mobile, `AnnouncementModalLayout` should transform to `FullScreenModalLayout` for promotions.

For smaller, less intrusive promotions you can use `Drawer` as well

_To see the change, toggle 'Enable mobile support' in the top bar of Storybook._

```jsx
() => {
  const [isLargeOpen, setIsLargeOpen] = React.useState(false);
  const [isSmallOpen, setIsSmallOpen] = React.useState(false);
  const { mobile } = React.useContext(WixDesignSystemContext);

  const title = 'Introducing AI Assistant';
  const subtitle =
    'Boost your productivity with smart suggestions powered by AI. Get instant answers, generate content, and automate repetitive tasks - all without leaving your workflow.';
  const illustration = (
    <Image src="generic_post.svg" width="120" height="120" />
  );

  return (
    <Box padding="20px" gap="SP2">
      <Button onClick={() => setIsLargeOpen(true)}>Large example</Button>
      <Button onClick={() => setIsSmallOpen(true)}>Small example</Button>

      {/* Large — AnnouncementModalLayout on desktop, FullScreenModalLayout on mobile */}
      {mobile ? (
        <Modal
          isOpen={isLargeOpen}
          onRequestClose={() => setIsLargeOpen(false)}
          screen="mobile"
        >
          <FullScreenModalLayout>
            <FullScreenModalLayout.Header
              startNode={
                <CloseButton
                  skin="dark"
                  size="large"
                  onClick={() => setIsLargeOpen(false)}
                />
              }
            >
              <Text size="small" weight="normal">
                {title}
              </Text>
            </FullScreenModalLayout.Header>
            <FullScreenModalLayout.Content padding>
              <Box direction="vertical" gap="SP4" align="center">
                {illustration}
                <Text>{subtitle}</Text>
              </Box>
            </FullScreenModalLayout.Content>
            <FullScreenModalLayout.Footer>
              <Box width="100%" direction="vertical" gap="SP2" align="center">
                <Button onClick={() => setIsLargeOpen(false)} fullWidth>
                  Try it now
                </Button>
                <TextButton onClick={() => {}}>Learn more</TextButton>
              </Box>
            </FullScreenModalLayout.Footer>
          </FullScreenModalLayout>
        </Modal>
      ) : (
        <Modal
          isOpen={isLargeOpen}
          onRequestClose={() => setIsLargeOpen(false)}
          shouldCloseOnOverlayClick
        >
          <AnnouncementModalLayout
            title={title}
            illustration={illustration}
            primaryButtonText="Try it now"
            primaryButtonOnClick={() => setIsLargeOpen(false)}
            linkText="Learn more"
            linkOnClick={() => {}}
            onCloseButtonClick={() => setIsLargeOpen(false)}
          >
            <Text>{subtitle}</Text>
          </AnnouncementModalLayout>
        </Modal>
      )}

      {/* Small — AnnouncementModalLayout on desktop, Drawer on mobile */}
      {mobile ? (
        <Drawer open={isSmallOpen} onClose={() => setIsSmallOpen(false)}>
          <Box direction="vertical" gap="SP4" padding="SP5">
            <Box align="space-between" verticalAlign="middle">
              <Text weight="bold">{title}</Text>
            </Box>
            <Text>{subtitle}</Text>
            <Box direction="vertical" gap="SP2">
              <Button onClick={() => setIsSmallOpen(false)} fullWidth>
                Try it now
              </Button>
              <Box align="center">
                <TextButton onClick={() => {}}>Learn more</TextButton>
              </Box>
            </Box>
          </Box>
        </Drawer>
      ) : (
        <Modal
          isOpen={isSmallOpen}
          onRequestClose={() => setIsSmallOpen(false)}
          shouldCloseOnOverlayClick
        >
          <AnnouncementModalLayout
            title={title}
            primaryButtonText="Try it now"
            primaryButtonOnClick={() => setIsSmallOpen(false)}
            linkText="Learn more"
            linkOnClick={() => {}}
            onCloseButtonClick={() => setIsSmallOpen(false)}
          >
            <Text>{subtitle}</Text>
          </AnnouncementModalLayout>
        </Modal>
      )}
    </Box>
  );
};
```

### Common use case examples

#### Promotions

Use `AnnouncementModalLayout` for Premium feature promotion

```jsx
() => {
  const [isOpen, setIsOpen] = React.useState(false);

  return (
    <Box padding="20px">
      <Button onClick={() => setIsOpen(true)}>Open Premium Modal</Button>
      <Modal isOpen={isOpen} onRequestClose={() => setIsOpen(false)}>
        <AnnouncementModalLayout
          skin="premium"
          illustration={'generic_upgrade.svg'}
          title="Unlock Premium Features"
          subtitle="Take your business to the next level with advanced tools
  and insights."
          primaryButtonText="Upgrade Now"
          primaryButtonOnClick={() => setIsOpen(false)}
          secondaryButtonText="Maybe later"
          secondaryButtonOnClick={() => setIsOpen(false)}
          linkText="Learn More"
          linkOnClick={() => setIsOpen(false)}
          onCloseButtonClick={() => setIsOpen(false)}
        />
      </Modal>
    </Box>
  );
};
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `actionsSize` | `"small" \| "tiny" \| "medium" \| "large"` | `'medium'` | Controls the size of the action buttons. |
| `children` | `ReactNode` | — | Accepts any item as a child element. For all common cases pass a standard text string. |
| `closeButtonProps` | `ModalCloseButtonProps` | — | Close button props. |
| `content` | `ReactNode` | — | Accepts any content to render in the modal body. Children passed directly are treated as `content` as well. |
| `contentClassName` | `string` | — |  |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute to be used in the tests. |
| `footerClassName` | `string` | — |  |
| `footnote` | `ReactNode` | — | Accepts any content to render as a footnote at the bottom of the modal. |
| `footnoteClassName` | `string` | — |  |
| `footnoteSkin` | `"light" \| "neutral"` | — | Sets the look and feel of the footnote. |
| `headerClassName` | `string` | — |  |
| `helpButtonProps` | `ModalControlButtonProps` | — | Help button props. |
| `illustration` | `ReactNode` | — | The illustration src or the illustration node itself. |
| `illustrationClassName` | `string` | — |  |
| `linkOnClick` | `() => void` | — | Defines a callback function which is called when the link is clicked. |
| `linkText` | `ReactNode` | — | When not provided, the primary link won't be rendered. |
| `onCloseButtonClick` | `MouseEventHandler` | — |  |
| `onHelpButtonClick` | `MouseEventHandler` | — |  |
| `primaryButtonOnClick` | `() => void` | — | a callback for when the primary action button is clicked. |
| `primaryButtonProps` | `Omit<ButtonProps, "internalDataHook">` | — | Passed to the primary action button as props without any filter / mutation. |
| `primaryButtonText` | `ReactNode` | — | Sets the text of the primary action button. |
| `primaryButtonTooltipProps` | `Omit<TooltipProps, "children">` | — |  |
| `secondaryButtonOnClick` | `() => void` | — | callback for when the secondary action button is clicked. |
| `secondaryButtonProps` | `Omit<ButtonProps, "internalDataHook">` | — | Passed to the secondary button as props without any filter / mutation. |
| `secondaryButtonText` | `ReactNode` | — | Sets the text of the secondary action button. |
| `sideActions` | `ReactNode` | — | Accepts any content to render as the first element on the same row as the action buttons. |
| `skin` | `"standard" \| "premium"` | — | Controls the skin of the modal. It's also applied to the footer buttons and the link. |
| `style` | `CSSProperties` | — |  |
| `subtitle` | `ReactNode` | — | The modal's subtitle. |
| `theme` | `"standard" \| "premium"` | — | Controls the skin of the modal. |
| `title` | `ReactNode` | — | The modal's title. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `getLinkText` | Returns if the link component text content |
| `clickLink` | Clicks the link component |
| `getTheme` | Gets the modal theme |
| `getSkin` | Gets the modal skin |
| `clickCloseButton` | Clicks the modal close-button |
| `clickHelpButton` | Clicks the modal help-button |
| `childExists` | Checks whether a node with the provided dataHook exists |
| `getTitleText` | Gets the title's text |
| `getSubtitleText` | Gets the subtitle's text |
| `secondaryButtonDriver` | Gets the secondary button driver |
| `getSecondaryButtonDriver` | Gets the secondary button driver |
| `primaryButtonDriver` | Gets the primary button driver |
| `getPrimaryButtonDriver` | Gets the primary button driver |
| `getPrimaryButtonTooltipContent` | Gets the primary button's tooltip content |
| `getIllustrationSrc` | Gets the illustration source |
| `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.339.0** (2026-10-19) — maintenance release, no component-specific changes
- **1.338.0** (2026-10-15) — maintenance release, no component-specific changes
- **1.335.0** (2026-10-12) — maintenance release, no component-specific changes
- **1.331.0** (2026-10-01) — maintenance release, no component-specific changes
- **1.330.3** (2026-09-29) — maintenance release, no component-specific changes
- **1.330.1** (2026-09-28) — maintenance release, no component-specific changes
- **1.329.0** (2026-09-24) — 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.308.0** (2026-08-04) — maintenance release, no component-specific changes
- **1.305.1** (2026-07-30) — maintenance release, no component-specific changes
- **1.305.0** (2026-07-28) — maintenance release, no component-specific changes
- **1.299.0** (2026-07-17) — breaking: update to harmony design tokens & "Help" icon ([#16577](invalid-url)) — has visual changes
- **1.292.0** (2026-06-22) — maintenance release, no component-specific changes
- **1.291.0** (2026-06-19) — maintenance release, no component-specific changes
- **1.288.0** (2026-06-15) — 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.260.0** (2026-03-17) — maintenance release, no component-specific changes
- **1.254.0** (2026-02-03) — maintenance release, no component-specific changes
- **1.253.0** (2026-01-30) — maintenance release, no component-specific changes
- **1.247.2** (2026-01-21) — maintenance release, no component-specific changes
- **1.235.0** (2025-12-04) — maintenance release, no component-specific changes
- **1.220.0** (2025-09-29) — maintenance release, no component-specific changes
- **1.214.0** (2025-08-22) — maintenance release, no component-specific changes
- **1.213.0** (2025-08-19) — maintenance release, no component-specific changes
- **1.202.0** (2025-06-27) — breaking: tokenization ([#15003](invalid-url))
- **1.196.0** (2025-06-04) — maintenance release, no component-specific changes
- **1.105.0** (2024-05-21) — 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