> For the complete documentation index, see [llms.txt](https://docs.roadmap.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roadmap.so/reviews/storefront-and-display/add-reviews-to-product-pages.md).

# Add reviews to product pages

### Overview

You can display Roadmap reviews directly on your product detail pages (PDPs) using the **Roadmap Reviews 2.0** app block. The block is added in the Shopify theme editor and inherits your theme’s design by default. If **Shared Reviews** is enabled, the same review content can be shown across multiple related products.

### Optional walkthrough

Open the [interactive Arcade walkthrough](https://app.arcade.software/flows/2GEsWM30f1zQjbLzkJFv).

If the Arcade link opens a sign-in page, open it in a browser where you’re already logged in, or ask your team admin for access to the flow.

### Add the Reviews block in Shopify

{% stepper %}
{% step %}

#### Open the theme editor

In Shopify, go to **Online Store** → **Themes** and click **Customize** on the theme you want to edit.
{% endstep %}

{% step %}

#### Select the product template

In the top dropdown, open the **Products** template you want to update (for example, your default product template or a custom product template).
{% endstep %}

{% step %}

#### Add the app block

Click **Add section** (or **Add block**, depending on your theme), then choose **Apps** → **Roadmap Reviews 2.0**.

Place it where you want reviews to appear (commonly below the product description or near the bottom of the PDP).
{% endstep %}

{% step %}

#### Save

Click **Save** in the theme editor.

Reviews will display on any product that uses this product template, as long as the **Roadmap Reviews 2.0** block/section is set to be visible. If you have multiple product templates, you’ll need to add **Roadmap Reviews 2.0** to each template where you want reviews to appear.
{% endstep %}
{% endstepper %}

### Configure how reviews display

In the Shopify theme editor, click the **Roadmap Reviews 2.0** block to open its settings. You can adjust:

* **Layout** — widths, padding, styles, and corner radius
* **Colours & Fonts** — font sizing and the colors for the review block elements

For advanced styling control, you can apply **custom CSS** (recommended only if you’re comfortable maintaining theme-level styling changes).

### Why show reviews on PDPs?

* **Build trust** — reviews reassure first-time buyers.
* **Boost conversions** — social proof helps shoppers decide faster.
* **Make PDPs more engaging** — reviews with photos add real customer context.

### Common questions

<details>

<summary>Can I choose where reviews display on the PDP?</summary>

Yes. In the Shopify theme editor, you can place the **Roadmap Reviews 2.0** block anywhere within your product template.

</details>

<details>

<summary>Do reviews support photos?</summary>

Yes. Photo uploads are supported and can display alongside written reviews (if enabled in your review settings).

</details>

<details>

<summary>Can reviews be styled to match my store?</summary>

Yes. The block inherits theme styling automatically, and you can further control styling using the block settings under **Layout** and **Colours & Fonts**, plus optional custom CSS.

</details>

<details>

<summary>Do star ratings show outside the PDP?</summary>

Star ratings can also be displayed in other places (for example, collections, search, or above the fold on the PDP). If you’d like help placing star ratings, contact Roadmap support for implementation guidance.

</details>

<details>

<summary>Why do I see the same review twice in the review block?</summary>

This usually means the same review exists as separate review records in more than one connected store.

The most common cause is importing the same historical review into each store, then enabling Shared Reviews across stores.

Import each historical review into one source store, then let Shared Reviews syndicate it to the mapped stores.

</details>

### Summary

* Add **Roadmap Reviews 2.0** to your product template in Shopify: **Online Store** → **Themes** → **Customize** → **Apps**.
* Adjust styling in the block settings: **Layout** and **Colours & Fonts** (plus optional custom CSS).
* If you want reviews shared across products, enable **Shared Reviews** in Roadmap’s Reviews settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.roadmap.so/reviews/storefront-and-display/add-reviews-to-product-pages.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.