For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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

1

Open the theme editor

In Shopify, go to Online Store → Themes and click Customize on the theme you want to edit.

2

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

3

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

4

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.

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

Can I choose where reviews display on the PDP?

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

Do reviews support photos?

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

Can reviews be styled to match my store?

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.

Do star ratings show outside the PDP?

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.

Why do I see the same review twice in the review block?

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.

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.

Last updated