FacesRatingBar

Components/Form

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

Overview

Copy

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

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

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.

Copy

Description

Show descriptions for each face in a tooltip.

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

Copy

Max Value

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

Copy

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

Copy

Common use case examples

Collecting feedback

Use an interactive mode to collect feedback from your users.

Copy

Displaying feedback

Use read only mode to display ratings.

Copy

Code

Copy

Props

NameTypeDefaultDescription
dataHookstring—Applies a data-hook HTML attribute that can be used in the tests.
descriptionValuesstring[]—Specifies the rate value descriptions' texts. The array length must match the maxValue prop number (5 by default).
disabledbooleanfalseSpecifies whether the rating bar is disabled. A disabled rating bar doesn't respond to hover, focus or clicks.
maxValue5 | 2 | 3 | 45Specifies 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
readOnlybooleanfalseSpecifies whether the rating bar is in read only mode.
size"small" | "medium"'medium'Controls the size of the faces.
valuenumber—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:

Copy

Driver methods

MethodDescription
selectRatingSelect the faces rating bar value
getSelectedRatingReturn the selected rating (a number between 0 to 5)
isDisabledReturns true when every face of the rating bar is disabled
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.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) — 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

Last updated: 30 October 2026

Did this help?