StatusIndicator

Components/Form

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

Overview

Copy

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.

Do

  • Use it to provide information about component status in compact layouts, where providing it below the component is not possible.

Don't

  • Don't use it as a standalone item to indicate loading for lists or layouts. Use <Loader/> instead.

Feature examples

Status

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.
Copy

Message

Explain the status with a message prop.

The message is revealed in a tooltip when the users' mouse hovers over the status icon.

Copy

Tooltip placement

Position the tooltip with the tooltipPlacement prop:

  • top (default)
  • right
  • bottom
  • left
Copy

Common use case examples

Built-in part of form elements

A 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.

Copy

Code

Copy

Props

NameTypeDefaultDescription
dataHookstring—Applies a data-hook HTML attribute that can be used in tests.
messageReactNode—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.
tooltipPropsTooltipCommonProps—Customize appearance with its props component.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
getStatusReturns the type of the status oneOf(error, warning, success, loading)
hasMessageReturns true if a message was provided
getMessageReturns the message text
existsChecks whether the component found with the given data hook.
elementGets the component root element.
clickClicks on the component root element.
baseReturns 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.336.0 (2026-10-13) — maintenance release, no component-specific changes
  • 1.330.3 (2026-09-29) — maintenance release, no component-specific changes
  • 1.330.0 (2026-09-28) — maintenance release, no component-specific changes
  • 1.327.0 (2026-09-21) — maintenance release, no component-specific changes
  • 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.323.0 (2026-09-10) — 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.291.0 (2026-06-19) — maintenance release, no component-specific changes
  • 1.277.0 (2026-05-07) — 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.247.2 (2026-01-21) — maintenance release, no component-specific changes
  • 1.240.0 (2025-12-16) — fix: shows tooltip when focused (#15666)
  • 1.194.0 (2025-05-30) — breaking: tokenization (#14916)
  • 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
  • 1.127.1 (2024-09-16) — maintenance release, no component-specific changes
  • 1.127.0 (2024-09-12) — feat: add success state (#14098)
  • 1.115.0 (2024-07-17) — maintenance release, no component-specific changes
  • 1.114.0 (2024-07-11) — maintenance release, no component-specific changes
  • 1.109.2 (2024-06-17) — maintenance release, no component-specific changes
  • 1.102.0 (2024-04-16) — maintenance release, no component-specific changes
  • 1.101.0 (2024-04-12) — fix: update type for message prop (#13590)
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 21 October 2026

Did this help?