# Product ratings

Broadcast has built-in support for Shopify's Product Reviews app. Star ratings can be shown throughout the theme. Here are some examples:

**Product Detail page** 

Star and average rating value next to product name:

![](https://content.gitbook.com/content/gPVWISoa427RKoZWt1y6/blobs/tVdTeGOKGyYhPCoQIuEF/Screen%20Shot%202022-07-13%20at%2011.40.55%20AM.png)

Individual reviews and form to add a new review can be shown with Broadcast's accordions or separate below the product description:

![](https://content.gitbook.com/content/gPVWISoa427RKoZWt1y6/blobs/15rFVZs7eU2MeBgcn6DT/Screen%20Shot%202022-07-13%20at%2012.37.12%20PM.png)

**Collection page and Product Grid sections**

Stars shown above product name and price:

![](https://content.gitbook.com/content/gPVWISoa427RKoZWt1y6/blobs/l5v2TyXPVBwH06yOLEds/Screen%20Shot%202022-07-13%20at%2011.39.02%20AM.png)

## How to setup

Broadcast includes quick and easy settings in the Theme Editor to display ratings. The main requirement is that you have the Shopify Reviews app installed:

![](https://content.gitbook.com/content/gPVWISoa427RKoZWt1y6/blobs/Suko9PhfCtOelrJuMNEG/Screen%20Shot%202022-07-13%20at%2011.59.12%20AM.png)

If you don't have the app installed, use this link to download and add:

{% embed url="<https://apps.shopify.com/product-reviews>" %}

### Theme Editor Settings

For the Product Detail page, you can easily add the rating value, star and number of ratings from the **Price and title** block under Product pages:

![](https://content.gitbook.com/content/gPVWISoa427RKoZWt1y6/blobs/U1bpbHcjQGZ9kNft9poa/Kapture%202022-07-13%20at%2012.18.28.gif)

There are checkboxes for the following:

* **Show ratings** - Displays the average rating value for the current product.&#x20;
* **Show star rating** - Adds the star icon next to rating number (requires show ratings to be checked as well)
* **Show rating count** - Displays the number of reviews for the current product.&#x20;

Broadcast includes a Reviews section on the Default product template, use that to display individual reviews and details:

![](https://content.gitbook.com/content/gPVWISoa427RKoZWt1y6/blobs/veVbcpKS4YVvKcohY9JF/Screen%20Shot%202022-07-13%20at%2012.31.18%20PM.png)

Setting options include:

* **Enable reviews** - Toggle to display reviews
* **Enable accordion** - Integrate with Broadcast's accordion section&#x20;

![Reviews section settings](https://content.gitbook.com/content/gPVWISoa427RKoZWt1y6/blobs/ID93LJRkURsRFT2ryjs0/Screen%20Shot%202022-07-13%20at%2012.33.39%20PM.png)

Alternatively, you can use App blocks to display the Product reviews and stars on the page:

![Alternate option to using Reviews section](https://content.gitbook.com/content/gPVWISoa427RKoZWt1y6/blobs/kujUkkxVEeIVNBT0JaBp/Screen%20Shot%202022-07-13%20at%2012.34.48%20PM.png)

{% hint style="info" %}
Accordion integration option is only available with the Reviews section.&#x20;
{% endhint %}

### Collection pages and Product Grid sections

To display the rating stars on a Collection page or Product Grid sections, use the Theme settings -> Product grid settings:

![Theme settings -> Product Grid](https://content.gitbook.com/content/gPVWISoa427RKoZWt1y6/blobs/RSQlCe8TUl5aonc1kDNA/Screen%20Shot%202022-07-13%20at%207.58.35%20AM.png)

Enable by using the checkbox:

![](https://content.gitbook.com/content/gPVWISoa427RKoZWt1y6/blobs/xMJFth5cC9j1tF0IiEeY/Screen%20Shot%202022-07-13%20at%2011.39.51%20AM.png)

**Save** your Theme Editor changes.&#x20;


---

# 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://broadcast.presidiocreative.com/broadcast-v3/products/product-ratings.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.