Components/Form
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/statusindicator
A status indicator highlights the status of UI elements with an explanatory message that's displayed in a tooltip. It's an internal component of various form inputs.
<Loader/> instead.Control the indication type with the status prop:
error - use it to highlight invalid values, failed actions and processes.warning - use it to highlight areas that require extra attention, like if a password has been compromised.success - use it to highlight valid values, successful actions or processes.loading - use it to show that an input value is being loaded.Explain the status with a message prop.
The message is revealed in a tooltip when the users' mouse hovers over the status icon.
Position the tooltip with the tooltipPlacement prop:
top (default)rightbottomleftA status indicator is used as a building block for a variety of form components that require validation or data processing. Avoid using these indicators for status messages unless absolutely necessary, like for very compact layouts.
Showing the status message directly below the component is preferred in all default cases. For this, use <FormField/> prop statusMessage.
| Name | Type | Default | Description |
|---|---|---|---|
dataHook | string | — | Applies a data-hook HTML attribute that can be used in tests. |
message | ReactNode | — | Sets the message that's displayed in a tooltip. If not set, the tooltip won't appear. |
status | "error" | "warning" | "loading" | "success" | — | Sets the indication type. |
tooltipPlacement | "right" | "left" | "top" | "bottom" | — | Defines which side the tooltip is placed on. |
tooltipProps | TooltipCommonProps | — | Customize |
Import the driver matching your test environment:
| Method | Description |
|---|---|
getStatus | Returns the type of the status oneOf(error, warning, success, loading) |
hasMessage | Returns true if a message was provided |
getMessage | Returns the message text |
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. |
Last updated: 21 October 2026