> For the complete documentation index, see [llms.txt](https://knowledgebase.qommentary.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.qommentary.com/qommentary-form/custom-data/adding-input-columns/rating.md).

# Rating

**Rating** controls are ideal for applying star grading systems to individual records.

**Data type**: `number`

### Adding a Rating control

1\. Edit your sheet\
2\. Click on the **Qommentary Form** extension\
3\. Expand **Input fields** section\
4\. Click on **Add input field**

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2Ffat9r1sCT4MHhobkvP7B%2Fimage.png?alt=media\&token=d5960bed-6a40-4b04-8773-751f92b0f4bd)

5\. Select **Rating** from the dropdown menu

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2FuNdcoLtYOvSycRnFmxH9%2Fimage.png?alt=media\&token=f0fcf6ab-3ef9-4d24-869b-2784e630b73a)

6\. Add a **label** to display in the form

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2Fpoyb03ucnpIVYNF0zN8a%2Fimage.png?alt=media\&token=d90cea0a-cf7b-4551-b8a9-408d6c271959)

7\. Add a **field** name

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2FalsibXSAYZuDMaF56esP%2Fimage.png?alt=media\&token=efdab749-026f-4b6f-bbab-d2a8dc7f4d0e)

{% hint style="danger" %}
If database is selected as data connection, then field name **must map** to destination table column name.
{% endhint %}

{% hint style="warning" %}
Field name cannot contain spaces.
{% endhint %}

8\. Click on **Done**

**Rating** input field can now be updated and saved.

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2Fn3cBRCTKJDeGtgH5FsEs%2Fimage.png?alt=media\&token=1e6d42a4-77f0-42b3-956f-4265292e847f)

### Changing max rating value

By default, the Rating control displays a maximum of 5-stars, If you wish to customize the maximum rating value, please follow these steps:

1\. Edit your sheet\
2\. Click on the **Qommentary Form** extension\
3\. Expand the **Input fields** section and **Rating** input field\
4\. Update the **Max Rating** field

![](https://3028830514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUSRPWcyYI4YAL7ad9DIS%2Fuploads%2Fd09orZK0m7IvfM7Mxl6H%2Fimage.png?alt=media\&token=aebcaf72-dde6-407a-913d-3995356fcbbb)