# CMS: Adding and Setting Up a Ratings Input Element

Source: https://support.wix.com/en/article/cms-adding-and-setting-up-a-ratings-input-element (updated 2026-11-11)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Adding a ratings input element to your site allows visitors to rate content, products, or services, and submit their ratings directly to your CMS (Content Management System) collection. This can provide valuable feedback and enhance user engagement.

![Screenshot of the ratings input element in the Wix Editor.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/26/f9f87d97-236a-46f8-9bb5-9252fec32501/40554d1b-cbff-4cf7-a224-48f6c8422537.png)

> **Before you begin:**
>
> * Make sure to [add the CMS](https://support.wix.com/en/article/cms-formerly-content-manager-getting-started) to your site if you haven't already.
> * Make sure you have [a collection with suitable permissions](https://support.wix.com/en/article/cms-creating-a-custom-form-with-input-elements-that-submit-to-your-collection#step-1-create-a-collection-and-set-the-permissions) for storing submissions from the ratings input element.

> **Note:** Input elements aren't available in the Wix Harmony Editor, so visitors can't filter your content or submit items to your collection. To collect information from visitors, add a form with Wix Forms instead. Learn more about [features that work differently in Wix Harmony](https://support.wix.com/en/article/wix-harmony-whats-new-with-the-cms#features-that-work-differently-in-wix-harmony).

---

## Step 1 | Add and set up the ratings input element

Add the ratings input element to your page and customize its settings, layout, and design.

**Wix Editor:**

1. Click **Add Elements** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/f0656688-8ed1-488a-888d-62373b7c3a3c/2021/08/23/fb2504cd-afa3-47dd-8e84-4cd32a0ea1ed/653ea261-d479-44ae-8509-7735843df25c.png) on the left side of the editor.
2. Click **Input**.
3. Click **Ratings**.
4. Click and drag the **Ratings Input** element of your choice onto the page.

![Screenshot of adding the Ratings input element in the Wix Editor.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/26/d16ce5f4-9d4c-42a1-8d05-dd4ee90e3d5f/01eba413-df84-4a02-b7dc-fe679ca5a3e6.png)

1. Set up the ratings:  
   1. Click **Set Up Ratings** on the ratings input element.  
   2. Enter the **Field title** that will display in the element.  
   3. Click the **Show hover text** toggle to choose whether to show hover text or not:  
         * **Enabled:** Display explanations for each rating option when visitors hover over the ratings. Enter the text in each rating field.  
         * **Disabled:** Explanations do not appear when visitors hover over the ratings. Click **Accessible names** and enter explanations for each rating that helps screen readers and assistive technology understand what each rating represents.  
   4. Select the **Required** checkbox if you want to make it mandatory that visitors select a rating before they can submit it as part of a [custom form](https://support.wix.com/en/article/cms-creating-a-custom-form-with-input-elements-that-submit-to-your-collection).
2. Click the **Layout** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/09/12/734557c6-c0b4-447f-b06b-913a6cdda087/7d44f8a6-1640-4519-95a4-01eafb2f0dcf.png) to customize the location of the field title and rating value. You can also set the title alignment and padding, the spacing and icon size, and the text direction.
3. Click the **Design** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/09/12/33af6f0f-b6ab-4e51-b58b-44f286e77642/959a4c6f-2294-42c7-ac5f-576b1be782d3.png) to choose a preset design. Then click **Customize Design** to adjust the design further.

**Studio Editor:**

1. Click **Add Elements** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2023/06/14/cef22a14-dfc9-43c7-a54f-72ed83266050/741248d2-4240-497e-a282-2a7d15d8afac.png) on the left side of the editor.
2. Click **Input**.
3. Click **Ratings**.
4. Click and drag the **Ratings Input** element of your choice onto the page.

![Screenshot of adding the Ratings input element in the Studio Editor.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/26/fb67acad-ac4a-4c38-a71b-df3db2790d20/4b4eb2ab-a674-4b98-b2a9-c7750ee72d7d.png)

1. Set up the ratings:  
   1. Click **Set Up Ratings** on the ratings input element.  
   2. Enter the **Field title** that will display in the element.  
   3. Click the **Show hover text** toggle to choose whether to show hover text or not:  
         * **Enabled:** Display explanations for each rating option when visitors hover over the ratings. Enter the text in each rating field.  
         * **Disabled:** Explanations do not appear when visitors hover over the ratings. Click **Accessible names** and enter explanations for each rating that helps screen readers and assistive technology understand what each rating represents.  
   4. Select the **Required** checkbox if you want to make it mandatory that visitors select a rating before they can submit it as part of a [custom form](https://support.wix.com/en/article/cms-creating-a-custom-form-with-input-elements-that-submit-to-your-collection).
2. Click the **Layout** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/09/12/5b409bb9-7658-4435-8125-dd9cf6760d7d/44e4410f-27cf-48ee-ab17-5cf00e9b61cd.png) to customize the location of the field title and rating value. You can also set the title alignment and padding, the spacing and icon size, and the text direction.
3. Click the **Design** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/09/12/33af6f0f-b6ab-4e51-b58b-44f286e77642/959a4c6f-2294-42c7-ac5f-576b1be782d3.png) in the Inspector panel to customize the design.

---

## Step 2 | Connect the ratings input to the CMS

Connect the ratings input element to a dataset that links to your CMS collection, allowing you to store and manage the ratings submitted by visitors.

**Wix Editor:**

1. In your editor, click the ratings input element.
2. Click the **Connect to CMS** icon![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/59ef43fb-880d-46b2-bdce-82e4aaffaaec/2020/07/04/49602af9-3e86-4883-9ae4-a88f13ea85c9/d7fb62f6-ed05-401e-ac3f-6a0f5ce4b20f.png) .
3. Click the **Choose a dataset** drop-down and select a dataset that connects to the collection where you will store the submissions. Alternatively, select **Add a Dataset**, then choose the collection you want to connect, give the dataset a name and click **Create**.
4. Click the **Rating value connects to** drop-down and choose the number field that the ratings input will submit to.  
**Tip:** Select **+ Add** to [add a new collection field](https://support.wix.com/en/article/cms-formerly-content-manager-adding-a-field-to-a-collection) for storing the submissions. Then enter the field name and field key (Velo only) and click **Add**.

![Screenshot of adding a new field for the ratings input element to submit to.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/26/b07e1ebd-c747-4702-bba4-4252bbd4f108/64872e30-2fbc-4483-939b-14ed7ab7dd67.png)

1. Set the dataset mode and collection permissions:
2. Click **Dataset Settings** in the panel on the right.
3. (Optional) Click the [permission type](https://support.wix.com/en/article/cms-collection-permissions-overview) next to **Permissions** to determine who can view, add, update, or delete collection content.
4. Click the **Dataset mode** drop-down and select the relevant option:  
   * **Write:** Connected [input elements](https://support.wix.com/en/article/cms-about-user-input-elements) can add new items to the collection, but cannot edit existing items.  
   * **Read & Write:** Connected elements can update existing items in the collection. If you connect a ['New' button](https://support.wix.com/en/article/cms-about-dataset-click-actions-for-buttons-and-images#new), visitors can use it to update existing items and add new items to your collection.
5. [Create a submit button](https://support.wix.com/en/article/cms-creating-a-custom-form-with-input-elements-that-submit-to-your-collection#step-5-create-a-submit-button) that visitors click to submit their ratings.

![Screenshot of adding and connecting a Submit button.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/26/40ef29e5-4741-4c7c-a54e-1dc2e6a644f8/91d9f236-7379-4528-9e04-5507a4326457.png)

**Studio Editor:**

1. In your editor, click the ratings input element.
2. Click the **Connect to CMS** icon![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/59ef43fb-880d-46b2-bdce-82e4aaffaaec/2020/07/04/49602af9-3e86-4883-9ae4-a88f13ea85c9/d7fb62f6-ed05-401e-ac3f-6a0f5ce4b20f.png) .
3. Click the **Choose a dataset** drop-down and select a dataset that connects to the collection where you will store the submissions. Alternatively, select **Add a Dataset**, then choose the collection you want to connect, give the dataset a name and click **Create**.
4. Click the **Rating value connects to** drop-down and choose the number field that the ratings input will submit to.  
**Tip:** Select **+ Add** to [add a new collection field](https://support.wix.com/en/article/cms-formerly-content-manager-adding-a-field-to-a-collection) for storing the submissions. Then enter the field name and field key (Velo only) and click **Add**.

![Screenshot of adding a field for the ratings to connect to.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/26/193abd48-06fb-4188-84d3-546f7001ee0a/4f3b367c-05cb-47a7-bfa2-406aff0cfd1e.png)

1. Set the dataset mode and collection permissions:
2. Click **Dataset Settings** in the panel on the right.
3. (Optional) Click the [permission type](https://support.wix.com/en/article/cms-collection-permissions-overview) next to **Permissions** to determine who can view, add, update, or delete collection content.
4. Click the **Dataset mode** drop-down and select the relevant option:  
   * **Write:** Connected [input elements](https://support.wix.com/en/article/cms-about-user-input-elements) can add new items to the collection, but cannot edit existing items.  
   * **Read & Write:** Connected elements can update existing items in the collection. If you connect a ['New' button](https://support.wix.com/en/article/cms-about-dataset-click-actions-for-buttons-and-images#new), visitors can use it to update existing items and add new items to your collection.
5. [Create a submit button](https://support.wix.com/en/article/cms-creating-a-custom-form-with-input-elements-that-submit-to-your-collection#step-5-create-a-submit-button) that visitors click to submit their ratings.

![Screenshot of adding and connecting a Submit button.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/26/40ef29e5-4741-4c7c-a54e-1dc2e6a644f8/91d9f236-7379-4528-9e04-5507a4326457.png)

---

## FAQs

Click a question below to learn more about the ratings input element.

**Can I use Velo to capture and display ratings?**

Absolutely. View a [Velo tutorial on capturing and displaying ratings](https://dev.wix.com/docs/develop-websites/articles/code-tutorials/wix-editor-elements/capturing-and-displaying-ratings) using the ratings input element and the ratings display element.

**What type of field can I connect the ratings input to?**

You can connect the ratings input element to the Number [field type](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-type) in the CMS collection where you will store the ratings.

**How can I display the submitted ratings on my site?**

Use the [ratings display element](https://support.wix.com/en/article/cms-adding-and-setting-up-a-ratings-display-element) to showcase the ratings you receive. You can connect the ratings display element to a field that stores the rating values and to another field that displays the total ratings submitted.

**What are the dataset modes I can use with the ratings input element?**

The dataset mode determines what actions can be done between the connected elements and your collection. 

  
 In the dataset you connect to your ratings input, you can use the following dataset modes: 

* **Write:** Connected [input elements](https://support.wix.com/en/article/cms-about-user-input-elements) can add new items to the collection, but cannot edit existing items.
* **Read & Write:** Connected elements can update existing items in the collection. If you connect a ['New' button](https://support.wix.com/en/article/cms-about-dataset-click-actions-for-buttons-and-images#new), visitors can use it to update existing items and add new items to your collection.

**Can I let visitors rate my Wix Stores products?**

You must [use Velo](https://dev.wix.com/docs/develop-websites/articles/code-tutorials/wix-e-commerce-stores/adding-ratings-and-reviews-to-a-wix-stores-site) to add ratings and reviews to your Wix Stores products.

**Are there any 3rd party apps I can add to handle ratings and reviews?**

Yes. As an alternative to the ratings input element, you can install the [Kudobuzz Review app](https://support.wix.com/en/article/wix-stores-adding-the-kudobuzz-reviews-app).
