> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Rating

> Add visual numeric ratings to records. Useful for quality, priority, satisfaction, and evaluation results.

A **Rating** field uses icons to show a score. It works well for customer satisfaction, product ratings, priority, idea scores, and performance reviews.

## Use Cases

| Scenario           | Good for                                          |
| ------------------ | ------------------------------------------------- |
| Product evaluation | Product, feature, or content ratings              |
| Service feedback   | Customer satisfaction and service quality ratings |
| Performance review | Employee, project, or vendor scores               |
| Priority judgment  | Urgency, value, or risk                           |

## Create and Configure

<Steps>
  <Step title="Choose the field type">
    Click the `+` icon on the right side of the table header, then choose **Rating** from the field type list.
  </Step>

  <Step title="Name the field">
    Enter a field name, such as "Customer Satisfaction", "Recommendation Score", or "Priority".
  </Step>

  <Step title="Set the maximum value">
    The default maximum is **5**. You can change it to **10** or another limit to set the available rating range.
  </Step>

  <Step title="Choose an icon style">
    Ratings use stars by default. You can choose another icon to match the meaning of the field.
  </Step>
</Steps>

## Settings

| Setting       | Description                                                              |
| ------------- | ------------------------------------------------------------------------ |
| Maximum value | Controls the rating limit, such as a 5-point or 10-point scale           |
| Icon style    | Controls the rating symbol, such as star, heart, thumbs-up, or lightbulb |

## Common Uses

* **Product review management**: Record product ratings, then filter for high-rated products.
* **Service feedback**: Collect customer satisfaction in support records and review service quality.
* **Employee performance review**: Score several capability areas in an HR review table.
* **Rating plus comment**: Use with a **Long Text** field to capture both a score and written feedback.

## Notes

* Rating values can be referenced by **Formula** fields to calculate averages or totals.
* Before setting the maximum value, align the team on what each score means.
* If you lower the maximum value later, such as changing 10 to 5, existing scores above the new limit may not display correctly. Check historical data before changing it.
