# CMS: Adding and Setting Up a Ratings Display Element

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

Add a ratings display element to your site to showcase user feedback and build trust with your audience. After adding and customizing the ratings display element, you connect it to your [CMS (Content Management System](https://support.wix.com/en/article/cms-content-management-system-an-overview)) collection and choose which Number fields to use for the rating values and total ratings.

![Screenshot of the Ratings Display element in the Wix Editor.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/30/4099ea45-a25a-4c21-8ff5-f1e69b1d71e0/3517d6f0-5242-4b3b-b2f2-cdb2f6f3bedd.png)

> **Notes:**
>
> * In the Wix Harmony Editor, you can connect text, image, and button elements to your collection, and connect galleries to 'Media Gallery' fields. You can't connect other elements, such as the ratings display element. You can [vote to connect more element types in Wix Harmony](https://support.wix.com/en/article/wix-harmony-editor-feature-request-connecting-additional-element-types-to-your-collection-2).
> * Need to collect ratings from visitors? [Add and set up the ratings input element](https://support.wix.com/en/article/cms-adding-and-setting-up-a-ratings-input-element), which allows visitors to click to rate your products, features, services and more. The ratings input element isn't available in the Wix Harmony Editor.

> **Before you begin:**
>
> * Make sure to [add the CMS](https://support.wix.com/en/article/cms-formerly-content-manager-getting-started) to your site or [enable coding](https://dev.wix.com/docs/develop-websites/articles/getting-started/getting-started-with-code) if you haven't already.
> * Make sure you have a [CMS collection](https://support.wix.com/en/article/cms-formerly-content-manager-creating-a-collection) that stores your ratings.

---

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

Add the ratings display 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 display element in the Wix Editor.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/30/1a575512-514d-4b64-b05d-5acb24ae1cab/05ab8141-441f-4ff1-bdcd-41db6f601be4.png)

1. Click **Settings** on the ratings display element and click the relevant tab to choose what is shown when there are ratings and when there are no ratings:  
   * **Ratings:** Choose what you want to show when there are ratings:  
         * **Show the rating value:** Enable the toggle to show the rating value as a number in addition to the rating icons.  
         * **Show the number of ratings:** Enable the toggle to show the total number of rankings.  
         * **Ratings text label:** Enter the text that appears next to the ratings (e.g. "Recommend it").  
   * **No Ratings:** Click the **No Ratings** tab and choose what displays when the element loads and there are no ratings: **Nothing**, **Icons**, or **Placeholder text**

![Screenshot of the Ratings display element's settings.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/30/5937922d-509c-4559-90a6-24b741c48d95/5aac79b5-3d95-407d-9cec-10edbb35fe0c.png)

1. 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 adjust the size, spacing, value placement, alignment and text direction.
2. 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 **Rating Display** under **Display**.
4. Click and drag the **Rating Display** element of your choice onto the page.

![Screenshot of adding the Rating Display element in the Studio Editor.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/30/c6384bfe-a370-4cc3-8a93-9722c401c3cb/24aeae23-9bd4-4574-bf2f-0b11476a0bc2.png)

1. Click **Settings** on the ratings display element and click the relevant tab to choose what is shown when there are ratings and when there are no ratings:  
   * **Ratings:** Choose what you want to show when there are ratings:  
         * **Show the rating value:** Enable the toggle to show the rating value as a number in addition to the rating icons.  
         * **Show the number of ratings:** Enable the toggle to show the total number of rankings.  
         * **Ratings text label:** Enter the text that appears next to the ratings (e.g. "Recommend it").  
   * **No Ratings:** Click the **No Ratings** tab and choose what displays when the element loads and there are no ratings: **Nothing**, **Icons**, or **Placeholder text**

![Screenshot of the Ratings Display settings in the Studio Editor.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/30/9f22404c-9d32-4184-a911-1f604f796694/27b2df72-2dd5-4925-80ef-ce1a7eb644d3.png)

1. 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 adjust the size, spacing, value placement, alignment and text direction.
2. 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 display to the CMS

Connect the ratings display element to a dataset that binds to your CMS collection that stores the rankings. You can connect the rating values and the number of ratings to a Number field type or a [Reference field](https://support.wix.com/en/article/cms-using-reference-fields-to-display-content-from-multiple-collections).

**Wix Editor:**

1. In your editor, click the ratings display 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 an existing dataset that connects to your collection. 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 select the Number field that contains the rating values you want to display.  
**Tip:** Select **+ Add** to add a Number field to your collection that will store the rating values.
5. Click the **Number of ratings connects to** drop-down and select a Number field that contains the total number of ratings.  
**Tip:** Select **+ Add** to add a Number field to your collection that will store the number of ratings.

![Screenshot of the Ratings display element's CMS connection options.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/30/a7b1188b-4290-44c0-9c00-9e19743eb8c1/e9993cae-6e3e-43c6-96d7-e570d7fdb1a1.png)

1. Set the dataset mode and collection permissions:  
   1. Click **Dataset Settings** in the panel on the right.  
   2. (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.  
   3. Click the **Dataset mode** drop-down and select **Read** or **Read & Write**.

**Studio Editor:**

1. In your editor, click the ratings display 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 an existing dataset that connects to your collection. 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 select the Number field that contains the rating values you want to display.  
**Tip:** Select **+ Add** to add a Number field to your collection that will store the rating values.
5. Click the **Number of ratings connects to** drop-down and select a Number field that contains the total number of ratings.  
**Tip:** Select **+ Add** to add a Number field to your collection that will store the number of ratings.

![Screenshot of the Ratings display element's CMS connection options.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/30/643c47c9-054c-4a4b-9dc6-f232bc39460b/c8dc9aa6-4958-4d67-92f9-5c2934e5d037.png)

1. Set the dataset mode and collection permissions:  
   1. Click **Dataset Settings** in the panel on the right.  
   2. (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.  
   3. Click the **Dataset mode** drop-down and select **Read** or **Read & Write**.

---

## FAQs

Click below for answers to common questions about displaying ratings on your site.

**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 display element to?**

You can connect the ratings display element to the 'Number' [field type](https://support.wix.com/en/article/cms-formerly-content-manager-about-your-collection-fields#field-type) and 'Reference' fields.

**How can I let visitors rate my features, products and services?**

Use the [ratings input element](https://support.wix.com/en/article/cms-adding-and-setting-up-a-ratings-input-element) to let visitors click to rate areas of your site. Their ratings are stored in a 'Number' field type in your CMS collection.

**What are the dataset modes I can use with the ratings display 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 display element, you can use the following dataset modes: 

* **Read:** Elements on your page can read and display content from your collection. Site visitors cannot modify the content in your collection.
* **Read & Write:** Elements on your page can read and display content from your collection. Visitors can interact with [user input elements](https://support.wix.com/en/article/cms-about-user-input-elements) and 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) to add or edit content in your collection.

**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).
