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

## Article: StatusIndicator Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/form/status-indicator-component.md

## Article Content:

# StatusIndicator

_Components/Form_

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

## Overview

```jsx
<Box align="center">
  <Box width="30%">
    <FormField label="Plan name">
      <Input
        status="error"
        placeholder="e.g., Silver Membership"
        statusMessage="This field is mandatory"
      />
    </FormField>
  </Box>
</Box>;
```

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.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <StorybookComponents.Stack alignItems="center">
    <StatusIndicator status="error" />
    <Text>Error</Text>
  </StorybookComponents.Stack>
  <StorybookComponents.Stack alignItems="center">
    <StatusIndicator status="warning" />
    <Text>Warning</Text>
  </StorybookComponents.Stack>
  <StorybookComponents.Stack>
    <StatusIndicator status="success" />
    <Text>Success</Text>
  </StorybookComponents.Stack>
  <StorybookComponents.Stack>
    <StatusIndicator status="loading" />
    <Text>Loading</Text>
  </StorybookComponents.Stack>
</StorybookComponents.Stack>;
```

#### Message

Explain the status with a `message` prop.

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

```jsx
<StatusIndicator message="Message in a tooltip explains the status" />;
```

#### Tooltip placement

Position the tooltip with the `tooltipPlacement` prop:

- `top` (default)
- `right`
- `bottom`
- `left`

```jsx
<StorybookComponents.Stack alignItems="center">
  <Text>Top:</Text>
  <StatusIndicator message="Top" tooltipPlacement="top" />
  <Text>Left:</Text>
  <StatusIndicator message="Left" tooltipPlacement="left" />
  <Text>Bottom:</Text>
  <StatusIndicator message="Bottom" tooltipPlacement="bottom" />
  <Text>Right:</Text>
  <StatusIndicator message="Right" tooltipPlacement="right" />
</StorybookComponents.Stack>;
```

### 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`.

```jsx
<Layout gap="48px">
  <Cell span={4}>
    <Box direction="vertical" gap="12px">
      <Heading size="tiny">For narrow layouts only:</Heading>
      <Box direction="vertical" gap="40px">
        <FormField label="Product name">
          <Input status="error" statusMessage="This field is mandatory" />
        </FormField>
        <FormField label="Select color">
          <AutoComplete
            status="warning"
            value="Green"
            statusMessage="This color already exists"
          />
        </FormField>
      </Box>
    </Box>
  </Cell>
  <Cell span={8}>
    <Box direction="vertical" gap="12px">
      <Heading size="tiny">For all default cases:</Heading>
      <FormField
        label="Product name"
        status="error"
        statusMessage="This field is mandatory"
      >
        <Input />
      </FormField>
      <FormField
        label="Select color"
        status="warning"
        statusMessage="This color already exists"
      >
        <AutoComplete value="Green" />
      </FormField>
    </Box>
  </Cell>
</Layout>;
```

## Code

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

### Props

| 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 <Tooltip/> appearance with its props component. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

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

## 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](invalid-url))
- **1.194.0** (2025-05-30) — breaking: tokenization ([#14916](invalid-url))
- **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](invalid-url))
- **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](invalid-url))
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes