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

## Article: FacesRatingBar Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/form/faces-rating-bar-component.md

## Article Content:

# FacesRatingBar

_Components/Form_

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

## Overview

```jsx
() => {
  const [value, setValue] = React.useState(3);
  return (
    <Box align="center">
      <FacesRatingBar value={value} onChange={setValue} />
    </Box>
  );
};
```

Faces rating bar allows you to rate an experience, such as an interview, a call with customer care or a doctor's appointment.

### Do

- Use it to display the rating of an experience.
- Use it to measure 'likability'.
- Use it to collect feedback about experiences that involve interaction with other people.

### Don't

- Don't use it to rate the quality of a physical or digital item. Use `<StarsRatingBar/>` instead.

### Feature examples

#### Mode

Specify the mode of component:

- `interactive` (default) - use it to collect individual feedback.
- `readOnly` - use it to display an overall rating.

```jsx
() => {
  const [value, setValue] = React.useState(3);
  return (
    <StorybookComponents.Stack>
      <FacesRatingBar value={value} onChange={setValue} />
      <FacesRatingBar value={3} readOnly />
    </StorybookComponents.Stack>
  );
};
```

#### Size

Control the size of the faces with the `size` prop:

- `medium` (default) - use in forms and feedback modals.
- `small` - use in dense layouts, such as table rows and cards.

```jsx
<StorybookComponents.Stack>
  <FacesRatingBar value={3} />
  <FacesRatingBar size="small" value={3} />
</StorybookComponents.Stack>
```

#### Disabled

Disable the rating bar with the `disabled` prop when the rating can't be changed yet. A disabled rating bar ignores hover, focus and clicks.

```jsx
<StorybookComponents.Stack>
  <FacesRatingBar value={0} disabled />
  <FacesRatingBar value={3} disabled />
</StorybookComponents.Stack>
```

#### Description

Show descriptions for each face in a tooltip.

Descriptions will only be shown if all 5 labels are defined.

```jsx
() => {
  const descriptionValues = [
    'Strong Negative',
    'Negative',
    'Neutral',
    'Positive',
    'Strong Positive',
  ];
  return <FacesRatingBar descriptionValues={descriptionValues} />;
};
```

#### Max Value

`maxValue` controls how many faces are shown (`2` to `5`).

```jsx
() => {
  const [rating, setRating] = React.useState(2);

  return (
    <Box gap="20px" direction="vertical">
      <FacesRatingBar
        maxValue={3}
        value={rating}
        onChange={setRating}
        descriptionValues={['Poor', 'Okay', 'Great']}
      />
    </Box>
  );
};
```

#### Status message

Add text that explains the status or what action the user should take with the `statusMessage` prop.

Show the status message inline, directly below the rating bar by wrapping it in a `<FormField/>` and adding `statusMessage`.

View more inline status message examples in `<FormField/>`.

```jsx
() => {
  const descriptionValues = [
    'Strong Negative',
    'Negative',
    'Neutral',
    'Positive',
    'Strong Positive',
  ];
  return (
    <FormField status="error" statusMessage="This is an error message.">
      <FacesRatingBar descriptionValues={descriptionValues} />
    </FormField>
  );
};
```

### Common use case examples

#### Collecting feedback

Use an interactive mode to collect feedback from your users.

```jsx
() => {
  const [value, setValue] = React.useState(3);
  const descriptionValues = ['Terrible', 'Bad', 'Okay', 'Good', 'Great'];
  const renderRatingBar = (
    <FormField label="How was the help you received from customer support?">
      <FacesRatingBar
        value={value}
        descriptionValues={descriptionValues}
        onChange={setValue}
      />
    </FormField>
  );
  const renderInput = (
    <FormField label="Review (optional)">
      <InputArea
        minHeight="90px"
        placeholder="Describe your experience. What went well and where could we improve?"
      />
    </FormField>
  );
  return (
    <CustomModalLayout
      primaryButtonText="Send a Review"
      secondaryButtonText="Cancel"
      onCloseButtonClick={() => {}}
      title="Rate your experience"
    >
      <Layout>
        <Cell span={12}>{renderRatingBar}</Cell>
        <Cell span={12}>{renderInput}</Cell>
      </Layout>
    </CustomModalLayout>
  );
};
```

#### Displaying feedback

Use read only mode to display ratings.

```jsx
<Card>
  <Card.Content>
    <Box direction="vertical" gap="18px">
      <Heading size="tiny">Collaboration</Heading>
      <FacesRatingBar value={4} readOnly />
      <Box gap="12px">
        <Text weight="bold" size="small">
          Positive:
        </Text>
        <Text weight="thin" size="small">
          Knows how to work in a team, seems like a good team player.
        </Text>
      </Box>
    </Box>
  </Card.Content>
</Card>;
```

## Code

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

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in the tests. |
| `descriptionValues` | `string[]` | — | Specifies the rate value descriptions' texts. The array length must match the maxValue prop number (5 by default). |
| `disabled` | `boolean` | `false` | Specifies whether the rating bar is disabled. A disabled rating bar doesn't respond to hover, focus or clicks. |
| `maxValue` | `5 \| 2 \| 3 \| 4` | `5` | Specifies the maximum rate value. |
| `onChange` | `(rating: number) => void` | — | Defines a handler that is called whenever a rating changes. ##### Signature: function(rating: number) => void * `rating`: 1 \| 2 \| 3 \| 4 \| 5 |
| `readOnly` | `boolean` | `false` | Specifies whether the rating bar is in read only mode. |
| `size` | `"small" \| "medium"` | `'medium'` | Controls the size of the faces. |
| `value` | `number` | — | Specifies the selected rate, from `0` to `maxValue`. `0` or no value indicates undefined rating. `readOnly` mode value can't be `0`. |

## Testkit

Import the driver matching your test environment:

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

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

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

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

### Driver methods

| Method | Description |
| --- | --- |
| `selectRating` | Select the faces rating bar value |
| `getSelectedRating` | Return the selected rating (a number between 0 to 5) |
| `isDisabled` | Returns true when every face of the rating bar is disabled |
| `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.345.0** — feat: add a `size` prop (`small` for 18px faces, `medium` by default) and a `disabled` prop that greys out the faces and ignores hover, focus and clicks, in interactive and read-only mode. ([#17588](invalid-url)) — has visual changes
- **1.344.0** (2026-10-28) — maintenance release, no component-specific changes
- **1.341.0** (2026-10-22) — maintenance release, no component-specific 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) — 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.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.250.0** (2026-01-27) — maintenance release, no component-specific changes
- **1.212.0** (2025-08-11) — maintenance release, no component-specific changes
- **1.165.0** (2025-02-27) — maintenance release, no component-specific changes
- **1.138.1** (2024-10-30) — maintenance release, no component-specific changes
- **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.92.1** (2024-02-05) — maintenance release, no component-specific changes