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

## Article: SectionHelper Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/feedback/section-helper-component.md

## Article Content:

# SectionHelper

_Components/Feedback_

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

## Overview

```jsx
<SectionHelper
  title="My Rewards page is removed"
  actionText="Add My Rewards Page"
  onAction={() => {}}
  onClose={() => {}}
>
  Members can now collect and redeem points, but they can't view their balance
  and available rewards.
</SectionHelper>;
```

Section helper is a notification message that allows us to communicate with users and provide feedback anywhere on the page.

### Do

- Use it to provide application-level status updates; for example, to inform the user that their payment method has expired.
- Use it to share the status of application sections; for example, to inform users that settings are turned on in a way that they might not prefer.

### Don't

- Don't use it for status updates after users perform actions, like validation errors and success messages. Use `<StatusToast/>` instead.

### Feature examples

#### Structure

The component consists of 4 majors elements: `title`, content, action and close button.

Control the action label with `actionText` and its interaction with `onAction` props, and the close button with the `onClose` prop.

```jsx
<SectionHelper
  title="Title"
  actionText="Action"
  onAction={() => {}}
  onClose={() => {}}
>
  Content
</SectionHelper>;
```

#### Size

Adjust the size of the section helper with the `size` prop:

- `medium` (default) can be used in all common cases.
- `small` is best for dense layouts.
- `tiny` fits a single line of text with an action, such as a strip inside a card.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHelper size="medium">Medium </SectionHelper>
  <SectionHelper size="small">Small </SectionHelper>
  <SectionHelper
    size="tiny"
    layout="horizontal"
    fullWidth
    actionText="Action"
    onAction={() => {}}
  >
    Tiny
  </SectionHelper>
</StorybookComponents.Stack>;
```

#### Skin

Control the style of the section helper with the `appearance` prop. It supports 7 options:

- `standard` is meant to provide additional information relevant to current user task.
- `success` is used to inform users about a successful action.
- `warning` (default) is intended to draw the user's attention to unresolved issues.
- `danger` is used for error messages and information about critical issues.
- `premium` is only intended for premium upgrades, packages that let users accept payments, connect domains, and have business email. [Read more about Premium patterns](https://docs.google.com/document/d/1mALfPW9BOZgAjaFpvor5la3WGhGkXIxpbkF2GFrapU0/edit).
- `preview` is meant to present process status or related additional data.
- `experimentalDark` is used to emphasize informational messages in the context of other content.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHelper appearance="standard">Standard </SectionHelper>
  <SectionHelper appearance="success">Success </SectionHelper>
  <SectionHelper appearance="warning">Warning </SectionHelper>
  <SectionHelper appearance="danger">Danger </SectionHelper>
  <SectionHelper appearance="premium">Premium</SectionHelper>
  <SectionHelper appearance="preview">Preview </SectionHelper>
  <SectionHelper appearance="experimentalDark">Dark </SectionHelper>
</StorybookComponents.Stack>;
```

#### Prefix

- Use the `showPrefixIcon` prop to show the default status icon.
- Add more context for the section helper by also using the `prefixIcon` prop.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHelper showPrefixIcon prefixIcon={<Icons.EmailAlert />}>
    Fix email value to save account details.
  </SectionHelper>
  <SectionHelper showPrefixIcon>Warning message</SectionHelper>
</StorybookComponents.Stack>;
```

#### Close button

Control whether the user can dismiss th section helper with the `showCloseButton` prop.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHelper>Non-dismissable</SectionHelper>
  <SectionHelper showCloseButton={true}>Dismissable</SectionHelper>
</StorybookComponents.Stack>;
```

#### Secondary action

Add a second, lower-emphasis action beside the main one with `secondaryActionProps`, passing its `label` and an `onClick` handler.

Keep `actionText` for the step you want people to take, and use the secondary action for the way out, postponing, dismissing or reading more.

```jsx
<SectionHelper
  title="Your domain expires in 5 days"
  actionText="Renew domain"
  onAction={() => {}}
  secondaryActionProps={{
    label: 'Remind me later',
    onClick: () => {},
  }}
>
  Renew before March 12 to keep bakery-and-co.com pointing at your site.
</SectionHelper>;
```

#### Border

Use the `border` prop to choose between:

- `standard` (default) for all common cases.
- `topBottom` for banner type use cases.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHelper border="standard">Standard</SectionHelper>
  <SectionHelper border="topBottom">Top bottom</SectionHelper>
</StorybookComponents.Stack>;
```

#### Layout

Change how the content and action are stacked using the layout props:

- `vertical` (default) arranges the content and action vertically.
- `horizontal` arranges the content and action horizontally.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHelper title="Title" actionText="Action" layout="vertical">
    Vertical content
  </SectionHelper>
  <SectionHelper title="Title" actionText="Action" layout="horizontal">
    Horizontal content
  </SectionHelper>
</StorybookComponents.Stack>;
```

#### Content width

Enable content width to be 100% wide with the `fullWidth` prop.

By default, the component's title and content are limited to a maximum width of 420 pixels to ensure readability.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <SectionHelper
    title="The Life and Strange Surprizing Adventures of Robinson Crusoe, Of York,
    Mariner: Who lived Eight and Twenty Years, all alone in an un-inhabited
    Island on the Coast of America, near the Mouth of the Great River of
    Oroonoque;"
  >
    Having been cast on Shore by Shipwreck, wherein all the Men perished but
    himself. With An Account how he was at last as strangely deliver'd by
    Pyrates.
  </SectionHelper>
  <SectionHelper
    fullWidth
    title="The Life and Strange Surprizing Adventures of Robinson Crusoe, Of York,
    Mariner: Who lived Eight and Twenty Years, all alone in an un-inhabited
    Island on the Coast of America, near the Mouth of the Great River of
    Oroonoque;"
  >
    Having been cast on Shore by Shipwreck, wherein all the Men perished but
    himself. With An Account how he was at last as strangely deliver'd by
    Pyrates.
  </SectionHelper>
</StorybookComponents.Stack>;
```

### Common use case examples

#### Application error

Errors occur because of breaches in application logic or conditions; for example, when users reach storage limits or their payment method has expired. These errors can occur before users even open the application or a specific page, making it essential for them to be visible upon arrival.

Place application errors at the top of the page below the page header using the error banner.

```jsx
<Page>
  <Page.Header
    title="Online Programs"
    subtitle="Build and market multi-step courses."
    actionsBar={
      <Box gap="SP2">
        <Button prefixIcon={<Icons.Add />}>Create New</Button>
      </Box>
    }
  />
  <Page.Content>
    <Layout>
      <Cell>
        <SectionHelper
          appearance="danger"
          title="Payment method expired"
          actionText="Update Payment Method"
          onAction={() => {}}
          onClose={() => {}}
        >
          The payment method linked to your account expired two days ago. To
          continue receiving payments for your online program, updated your
          payment details.
        </SectionHelper>
      </Cell>
      <Cell>
        <Card>
          <Card.Content>
            <Box height="120px" />
          </Card.Content>
        </Card>
      </Cell>
      <Cell>
        <Card>
          <Card.Content>
            <Box height="120px" />
          </Card.Content>
        </Card>
      </Cell>
    </Layout>
  </Page.Content>
</Page>;
```

#### Inline with content

Place the section helper at the top of the section that it applies to.

```jsx
<Card hideOverflow>
  <Card.Header
    title="Earn points"
    subtitle="These are the ways customers earn points."
  />
  <SectionHelper
    fullWidth
    size="small"
    border="topBottom"
    showCloseButton
    showPrefixIcon
    layout="horizontal"
  >
    You don't have ways of Earning Points enabled, so users can't collect
    points. Enable at least one of the way below.
  </SectionHelper>

  <TableListItem
    showDivider
    options={[
      {
        value: (
          <FormField label="Inactive" labelPlacement="right">
            <ToggleSwitch size="medium" />
          </FormField>
        ),
        width: 'auto',
      },
      {
        value: (
          <Box direction="vertical">
            <Text size="small" weight="bold">
              Make a Restaurant Order
            </Text>
            <Text size="small">Give 1 points for every 1$ spent.</Text>
          </Box>
        ),
      },
      {
        value: (
          <IconButton priority="secondary" size="small">
            <Icons.MoreSmall />
          </IconButton>
        ),
        width: 'auto',
      },
    ]}
  />
  <TableListItem
    options={[
      {
        value: (
          <FormField label="Inactive" labelPlacement="right">
            <ToggleSwitch size="medium" />
          </FormField>
        ),
        width: 'auto',
      },
      {
        value: (
          <Box direction="vertical">
            <Text size="small" weight="bold">
              Sign Up to the Site
            </Text>
            <Text size="small">Give 100 points after sign up.</Text>
          </Box>
        ),
      },
      {
        value: (
          <IconButton priority="secondary" size="small">
            <Icons.MoreSmall />
          </IconButton>
        ),
        width: 'auto',
      },
    ]}
  />
</Card>;
```

#### In front of content

Position the section helper on top of content in modals to update users about the status change.

```jsx
() => {
  const [state, setState] = React.useState(true);
  return (
    <CustomModalLayout
      title="Account details"
      subtitle="Manage name and email details."
      secondaryButtonText="Cancel"
      primaryButtonText="Save"
      showHeaderDivider
      overflowY="visible"
      onCloseButtonClick={() => setState(true)}
      primaryButtonOnClick={() => setState(true)}
      secondaryButtonOnClick={() => setState(true)}
    >
      <Layout>
        {state && (
          <Box
            position="absolute"
            top="24px"
            left="50%"
            transform="translateX(-50%)"
          >
            <SectionHelper
              appearance="danger"
              size="small"
              showCloseButton
              showPrefixIcon
              layout="horizontal"
              onClose={() => setState(false)}
            >
              Fix email value to save account details.
            </SectionHelper>
          </Box>
        )}
        <Cell span={6}>
          <FormField label="First name">
            <Input defaultValue="John" />
          </FormField>
        </Cell>
        <Cell span={6}>
          <FormField label="Last name">
            <Input defaultValue="Smith" />
          </FormField>
        </Cell>
        <Cell>
          <FormField
            label="Email address"
            status="error"
            statusMessage='Provide the email in format "your@email.com"'
          >
            <Input defaultValue="asfljaokfjalk" type="email" />
          </FormField>
        </Cell>
      </Layout>
    </CustomModalLayout>
  );
};
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `actionDisabled` | `boolean` | — | Disables the action button. |
| `actionText` | `ReactNode` | — | Text or any child component for the action button. |
| `appearance` | `"warning" \| "standard" \| "premium" \| "success" \| "danger" \| "preview" \| "experimentalDark"` | — | Sets the look and feel of the component. Used only when `skin` isn't set. |
| `border` | `"standard" \| "topBottom"` | `standard` | Controls the component border. |
| `children` | `ReactNode` | — | Sets the body content of the section helper. |
| `dataHook` | `string` | — | Applied as data-hook HTML attribute that can be used in the tests. |
| `fullWidth` | `boolean` | — | Set the content width to 100%. |
| `layout` | `"horizontal" \| "vertical"` | `vertical` | Controls the component layout. |
| `onAction` | `MouseEventHandler` | — | When provided, displays an action button that invokes this callback on click. |
| `onClose` | `MouseEventHandler` | — | Defines a callback function which is called when the close button is clicked. The close button is displayed only when `showCloseButton` is `true`. |
| `prefixIcon` | `ReactNode` | — | Overrides default prefix icon. |
| `secondaryActionProps` | `{ label?: ReactNode; onClick?: MouseEventHandler<HTMLButtonElement> \| undefined; }` | — | Defines properties for the secondary action button. |
| `showCloseButton` | `boolean` | — | Specifies whether the close button is displayed. |
| `showPrefixIcon` | `boolean` | — | Enables showing prefix icon. |
| `size` | `"small" \| "tiny" \| "medium"` | — | Controls the component padding. |
| `skin` | `"warning" \| "standard" \| "premium" \| "success" \| "danger" \| "preview" \| "experimentalDark"` | — | Sets the look and feel of the component. |
| `title` | `ReactNode` | — | Adds text as the title. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `hasSize` | Checks whether the resolved rendered size matches the given size, including defaults |
| `titleText` | Gets the title text |
| `actionText` | Gets the action text |
| `clickAction` | Clicks the action |
| `isActionDisabled` | Checks whether the action button is disabled |
| `secondaryActionText` | Gets the secondary action text |
| `clickSecondaryAction` | Clicks the secondary action |
| `isSecondaryActionDisplayed` | Checks whether the secondary action is displayed |
| `clickClose` | Clicks the close button |
| `isCloseButtonDisplayed` | Checks whether the close button is displayed |
| `hasPrefix` | Checks whether the prefix is displayed |
| `textContent` | Gets the text content |
| `isWarning` | Checks whether the component appears as "warning" |
| `isStandard` | Checks whether the component appears as "standard" |
| `isDanger` | Checks whether the component appears as "danger" |
| `isExperimentalDark` | Checks whether the component appears as "experimentalDark" |
| `isSuccess` | Checks whether the component appears as "success" |
| `isPremium` | Checks whether the component appears as "premium" |
| `isPreview` | Checks whether the component appears as "preview" |
| `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.342.0** (2026-10-26) — maintenance release, no component-specific changes
- **1.341.0** (2026-10-22) — breaking: on mobile, text that was 12px is now 14px: the message in Harmony (odeditor), and the title and message in Studio 2.0 (odeditor-dark, studio2-light) and Studio (studio). ([#17574](invalid-url)) — has visual changes
- **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) — breaking: the `experimentalDark` skin stands out more in Studio 2.0 (odeditor-dark). Its background is a stronger blue tint and its border matches the blue of the primary action button. Other themes are unchanged. ([#17450](invalid-url)) — has visual changes
- **1.335.0** (2026-10-12) — maintenance release, no component-specific changes
- **1.332.0** (2026-10-05) — maintenance release, no component-specific changes
- **1.331.0** (2026-10-01) — maintenance release, no component-specific changes
- **1.330.3** (2026-09-29) — fix: the `experimentalDark` skin is a light lavender banner with a visible border in Studio 2.0 (odeditor-dark), matching the `standard` skin in Harmony (odeditor), instead of the white-on-white it rendered there. Other themes are unchanged. ([#17285](invalid-url)) — has visual 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.327.0** (2026-09-21) — maintenance release, no component-specific changes
- **1.326.0** (2026-09-17) — maintenance release, no component-specific changes
- **1.325.0** (2026-09-17) — maintenance release, no component-specific changes
- **1.313.1** (2026-08-18) — feat: new `secondaryActionProps` prop adds an optional secondary action next to the action button, rendered as a text button. In the horizontal layout it sits to the left of the action button, in the vertical layout to its right. ([#16774](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.291.0** (2026-06-19) — maintenance release, no component-specific changes
- **1.282.0** (2026-05-27) — feat: add actionDisabled prop to action button ([#16307](invalid-url))
- **1.278.0** (2026-05-08) — maintenance release, no component-specific changes
- **1.272.0** (2026-04-27) — 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.247.2** (2026-01-21) — maintenance release, no component-specific changes
- **1.242.0** (2025-12-19) — maintenance release, no component-specific changes
- **1.220.0** (2025-09-29) — maintenance release, no component-specific changes
- **1.214.2** (2025-08-25) — fix: remove char from stylesheet ([#15236](invalid-url))
- **1.213.0** (2025-08-19) — breaking: add tokens ([#15186](invalid-url))
- **1.212.0** (2025-08-11) — fix: broken legacy testkit ([#15177](invalid-url))
- **1.196.0** (2025-06-04) — maintenance release, no component-specific changes
- **1.195.0** (2025-06-03) — maintenance release, no component-specific changes
- **1.161.0** (2025-02-12) — maintenance release, no component-specific changes
- **1.154.0** (2025-01-16) — fix: testkit ([#14463](invalid-url))
- **1.146.0** (2024-12-10) — feat: override `font-size` and `line-height` for studio tokens ([#14337](invalid-url))
- **1.143.0** (2024-11-25) — maintenance release, no component-specific changes
- **1.137.0** (2024-10-25) — fix: fix button overflow on horizontal layouts ([#14240](invalid-url))
- **1.135.0** (2024-10-23) — feat: add prefix icon ([#14219](invalid-url))
- **1.134.1** (2024-10-21) — fix: fix content overflow ([#14230](invalid-url))
- **1.134.0** (2024-10-18) — feat: introduce layout with vertical and horizontal values ([#14203](invalid-url))
- **1.134.0** (2024-10-18) — feat: add border support ([#14204](invalid-url))
- **1.132.0** (2024-10-11) — fix: fix default showCloseButton value ([#14212](invalid-url))
- **1.131.0** (2024-10-10) — maintenance release, no component-specific changes
- **1.120.1** (2024-08-08) — breaking: fix spacing between content and action ([#13968](invalid-url))
- **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