> For the complete documentation index, see [llms.txt](https://docs.themeware.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.themeware.design/additional-features/extensions/rating-on-product-pages.md).

# Rating on product pages

The **product rating** shows the average rating of a product in the buy box – the stars plus the number of reviews, linking to the review tab.

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

{% hint style="success" %}
**Looking for the rating in the product box?** For listing pages it is described in the article [Rating](/additional-features/extensions/product-boxes/rating.md).
{% endhint %}

{% hint style="info" %}
**Note**: Product reviews are a core function of Shopware. ThemeWare® merely extends how they are displayed in the buy box – above all with the "always show product rating" option.

Whether reviews are possible and visible at all is controlled centrally in the Shopware settings ("Settings" > "Shop" > "Products" > "Show reviews"). To learn how to manage, approve and comment on reviews, see: [Reviews](https://knowledge.themeware.design/knowledge-base/shopware/configuration/reviews)
{% endhint %}

***

## Configuration

### **Theme configuration**

1. Go to the "**Product pages**" tab
2. Expand the "**Product rating (in the buy box or at the product name)**" block
3. Choose the desired option under "**Show product rating**"
4. Under "**Placement**" define where the rating appears
5. Under "**Arrangement**" define whether the stars and the link sit next to or below each other
6. Save your changes after editing

### **Content**

* Edit the invitation shown for products without reviews using the snippet `twt.detail.reviews.linkTextNoReviews`
* The stars and the number of reviews are added automatically

{% hint style="info" %}
**Note**: For information on how to edit snippets, see the following instructions: [Texts: Editing and translation](https://knowledge.themeware.design/knowledge-base/tutorials/texts-editing-and-translation)
{% endhint %}

***

## Options

* **Show product rating**
  * "don't show": The rating does not appear in the buy box.
  * "show (default)": The rating appears as soon as the product has been rated – this is how Shopware behaves out of the box.
  * "always show product rating": The rating also appears for products that have not been rated yet. Instead of the review count, an invitation to write the first review is shown, which also leads to the review tab.

{% hint style="success" %}
**Tip**: "always show product rating" has two benefits: the buy box keeps its height and does not jump as soon as the first rating comes in – and you actively invite your customers to write that first review.
{% endhint %}

{% hint style="info" %}
**Note**: This configuration only refers to the display in the buy box. The "Reviews" tab on the product page is not affected – it remains available even with "don't show", including the review form.
{% endhint %}

* **Placement**
  * "below the price (default)": The rating stays at its Shopware position in the buy box.
  * "above the product name": The rating moves above the heading.
  * "below the product name": The rating moves below the heading.
* **Arrangement**
  * "below each other (default)": The stars sit above the link to the reviews – this is how Shopware behaves out of the box.
  * "next to each other": Stars and link sit in one line.

<figure><img src="/files/uRM6CjtuRhFEnmEIcQpU" alt=""><figcaption><p>below each other | next to each other</p></figcaption></figure>

{% hint style="info" %}
**Note**: The placements at the product name also apply to the ThemeWare® image gallery blocks with product name.

In the "next to each other" arrangement the link automatically moves below the stars when there is not enough room – for example in a narrow buy box or on a smartphone.
{% endhint %}

***

## Appearance of the stars

How the stars themselves are drawn is defined centrally via the "**Star style**" – solid or as an outline. The setting applies everywhere stars appear, so in the product box and in the testimonials as well. The same is true for the "Star" and "Star (blank)" colours.

> Tab "Layout" => Block "Product rating" => Section "Basic configuration" => Star style

***

## Summary

#### Theme configuration

* Tab "Product pages" => Block "Product rating (in the buy box or at the product name)" => Show product rating
* Tab "Product pages" => Block "Product rating (in the buy box or at the product name)" => Section "Basic configuration" => Placement
* Tab "Product pages" => Block "Product rating (in the buy box or at the product name)" => Section "Basic configuration" => Arrangement
* Tab "Layout" => Block "Product rating" => Section "Basic configuration" => Star style
* Tab "Layout" => Block "Product rating" => Section "Colour configuration" => Star
* Tab "Layout" => Block "Product rating" => Section "Colour configuration" => Star (blank)

#### Snippet

* `twt.detail.reviews.linkTextNoReviews`