Shopify Hydrogen is a headless React framework — it doesn't use Shopify's standard theme system, so REVIEWS.io app embeds and app blocks won't work. The recommended integration path is the Reviews API, which gives you full control over how review content is fetched and rendered in your Hydrogen components.
Requirements
⭐️ Available on the Plus Plan or above.
Don't meet the requirements? Upgrade now to get access.
You'll also need a developer to implement the integration — the Reviews API requires custom code in your Hydrogen project.
Step 1: Get your API credentials
Your Store ID and API Key are required to authenticate requests to the Reviews API. To find them:
Navigate to Integrations
Select API
Copy your URL, Store ID, and API Key from the API Credentials section
Note: the Store ID is sometimes referred to as the url_key depending on the platform or library you're using.
Step 2: Use the API to render reviews
The Reviews API lets you fetch review data and build custom widgets directly inside your Hydrogen components. To access the API widget reference in your dashboard:
Navigate to Publishing >> Widget Library
Select API
This gives you the API-powered widget configuration, which you can use as a reference when building your Hydrogen components.
Full API documentation — including endpoints, parameters, and response shapes — is available here: api.reviews.co.uk/documentation
Key endpoints for Hydrogen
Single product page (PDP)
Fetch reviews for a specific product by its SKU:
GET https://api.reviews.io/reviews?store={store_key}&type=product_review&sku={sku}Product listing / collection page (PLP)
Fetch review counts and average ratings for multiple products in bulk. Pass SKUs separated by semicolons:
GET https://api.reviews.io/product/rating-batch?store={store_key}&sku={sku1;sku2;sku3}Step 3: Sync your product catalogue
To match reviews to the correct products in your Hydrogen storefront, you'll need to connect your product feed. In your REVIEWS.io dashboard:
Go to Collection >> Product Catalogue
Connect your product feed — options include a custom feed URL, CSV upload, or manual entry
Once synced, the API will be able to return reviews matched to specific products using your product identifiers.
Need help?
If you need assistance setting up the integration or have questions about specific API endpoints, reach out to our support team and we'll connect you with the right resources.