---
title: "Rating"
description: "Collect an integer rating and optionally mark a five-step scale as CSAT."
group: "Build forms"
order: 10
type: "reference"
parent: "fields"
keywords:
  - "rating"
  - "stars"
  - "CSAT"
  - "insightsMetric"
updated: "2026-07-14"
---

The rating field collects an integer from 1 through its configured maximum.

## Options

| Option | Type | Default | Behavior |
| --- | --- | --- | --- |
| `max` | `number` | `5` | Sets the highest rating step |
| `insightsMetric` | `csat` | none | Labels a 1-to-5 rating for CSAT analysis |

Fillo rejects fractions and values outside the range. `insightsMetric: "csat"` requires a five-step rating, and it changes how Insights interprets the answer — not the stored integer.

## Add a rating field

In the dashboard, select **Add block**, choose **Rating**, and choose **CSAT** only for a standard five-point satisfaction question.

```ts
const satisfactionField = {
  id: "satisfaction",
  kind: "rating",
  label: "How satisfied are you?",
  max: 5,
  insightsMetric: "csat",
  required: true,
} as const;
```

## Related

- [Linear scale](/docs/fields/linear-scale): Build a labeled 0-to-10 NPS question.
- [Build a CSAT survey](/guides/build-a-csat-survey): Add a follow-up and interpret the result.
- [Responses and insights](/docs/responses): Filter ratings and inspect score summaries.