Components/Feedback
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/sectionhelper
Section helper is a notification message that allows us to communicate with users and provide feedback anywhere on the page.
<StatusToast/> instead.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.
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.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.preview is meant to present process status or related additional data.experimentalDark is used to emphasize informational messages in the context of other content.showPrefixIcon prop to show the default status icon.prefixIcon prop.Control whether the user can dismiss th section helper with the showCloseButton prop.
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.
Use the border prop to choose between:
standard (default) for all common cases.topBottom for banner type use cases.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.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.
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.
Place the section helper at the top of the section that it applies to.
Position the section helper on top of content in modals to update users about the status change.
| 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. |
Import the driver matching your test environment:
| 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. |
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) — has visual changesexperimentalDark 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) — has visual changessecondaryActionProps 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) — has visual changesfont-size and line-height for studio tokens (#14337)Last updated: 26 October 2026