Reviews
The Reviews API allows you to request an app review modal overlaid on your embedded app in the Shopify admin. You control when to request a modal, but it will only be displayed to the merchant if certain conditions are met.
Anchor to reviewsReviews
The Reviews API provides a request()
method that allows you to request an app review modal.
Request an app review modal
Preview

Anchor to responsesResponse codes and messages
A request to the Reviews API will return one of the following responses:
success | code | message |
---|---|---|
true | success | Review modal displayed |
false | mobile-app | Review modal not supported on mobile devices |
false | already-reviewed | Merchant already reviewed this app |
false | annual-limit-reached | Review modal already displayed the maximum number of times within the last 365 days |
false | cooldown-period | Review modal already displayed within the last 60 days |
false | merchant-ineligible | Merchant isn't eligible to review this app |
Anchor to rate-limits-restrictionsRate limits and restrictions
A review modal will only be displayed to the merchant if certain conditions are met. Be sure to follow the recommended best practices for requesting reviews.
Rate limits
The Reviews API applies rate limits to ensure a good merchant experience and to prevent abuse. A review modal will only be displayed to a merchant:
- Once within any 60-day period, and
- Three times within any 365-day period.
Restrictions
A review modal will never be displayed in these cases:
- The merchant already reviewed your app.
- The merchant is on a mobile device.
- The merchant is ineligible to leave a review.
Anchor to best-practicesBest practices for review requests
Because you can make only a limited number of requests for review, make sure to choose the right time:
- Do request a review at the end of a successful workflow.
- Don't request a review at any point that interrupts a merchant task.
- Don't request a review as soon as the merchant opens your app.
- Don't trigger a request with a button, link, or other call to action. Because the request might be rate-limited and the modal isn't guaranteed to display, your app UI would appear to be broken.