# Star rating

## 1. Turn on Star Ratings

Open **Air Reviews** app.

Go to **"Display Reviews"** and click on **"Setup"** in the **"Star Rating"** box.

<figure><img src="/files/nCTvtMswNunKe62e5vYf" alt=""><figcaption></figcaption></figure>

Toggle the **"Star Rating"** button on to enable Star rating.

<figure><img src="/files/kiCOpZHGveL7Lchs7r3u" alt=""><figcaption></figcaption></figure>

## 2. Show Ratings on Products Page

Go to **"Theme"** and choose **"Customize".**

<figure><img src="/files/RvTqsdSZ7Yax6ACOGz5H" alt=""><figcaption></figcaption></figure>

Select **"Products page".**

<figure><img src="/files/LrCVUArUXyFHkA7Xc56h" alt=""><figcaption></figcaption></figure>

Click **"Add Block"**, then click on **"Apps"**, and choose **"Stars Rating".**

<figure><img src="/files/r1gfb6oFa5QBVTia3bpi" alt=""><figcaption></figcaption></figure>

Drag the Stars Rating block to where you want it on the products page.

* Click "**Save**" to successfully complete the process

<figure><img src="/files/DYKoNWbuocXGtMdtoGKT" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
With themes that do not support OS 2.0, you just need to enable it in the app and click Save to show star rating on product pages. This is how:
{% endhint %}

<figure><img src="/files/aGH9ti3OX8jskss7ahtx" alt=""><figcaption></figcaption></figure>

## 3. Show Ratings on Home & Collection Page

Inside the “Star rating” feature, Turn on the options for **"Collection pages"** and **"Home page"**

<figure><img src="/files/allZA8LjK4Cn4XZWcci5" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}

#### Note

Before the restriction of [Asset API](https://shopify.dev/docs/api/admin-rest/2023-10/resources/asset), we could automatically add the snippet to your theme code. However, we can no longer now, you will need to add our snippet to your theme. So, to show star rating on Home page và Collection pages, please [follow this guide.](https://help.useair.app/airreviews/add-star-rating-to-product-card)
{% endhint %}

## 4. Customize Ratings on Products Page

Choose your preset:

* **Simple**: Shows star rating and review count.

<figure><img src="/files/CXYe19n6U0iJlkLoIGwX" alt=""><figcaption></figcaption></figure>

**Detailed**:  Shows star rating, total reviews, average rating, and more.

* Separated **total reviews**: Shows star rating and review count on separate lines.

<figure><img src="/files/pLCrJrkIzONuNdBIsXbP" alt=""><figcaption></figcaption></figure>

* **Total reviews** in Star Rating: Shows review count within the star rating.

<figure><img src="/files/Gcvg153IDhR1ADGUov6y" alt=""><figcaption></figcaption></figure>

* **Average Rating** in Star Rating: Shows average rating within the star rating.

<figure><img src="/files/jVO1frU9osIlAmsOo3Mf" alt=""><figcaption></figcaption></figure>

## 5. Advanced Settings

Turn on "Only show review star on products with reviews" to only show ratings for products with reviews.

<figure><img src="/files/ujm80dXXyVVvHg9oRrCp" alt=""><figcaption></figcaption></figure>

Use the provided snippet code to <mark style="color:orange;">place the star rating in a specific location</mark> on the <mark style="color:orange;">product page</mark>. Here's how:

1. Copy the **snippet code**.

<figure><img src="/files/7c4ry7twABNRATiicTCD" alt=""><figcaption></figcaption></figure>

2. Go to **"Theme"**,&#x20;
3. In the "**Current theme**", click on "**Actions**", and click on "**Edit code**."

<figure><img src="/files/XpRanT7aXyGnJ2n0eEHe" alt=""><figcaption></figcaption></figure>

4. Select <mark style="color:blue;">"main-product.liquid"</mark> file, then paste the code where you want it, and **Save** the file.&#x20;

<figure><img src="/files/DA8RWm4FQvf5srupEVWb" alt=""><figcaption></figcaption></figure>

5. Have a look at the result.

<figure><img src="/files/OInkhuVRGgqx3flYpzls" alt=""><figcaption></figcaption></figure>

*And that's it! You've successfully set up and displayed star ratings on your store. If you have any questions or need further assistance, please don't hesitate to ask. Happy selling!*

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.airreviews.io/display-reviews/star-rating.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.