How to integrate with Judge.me


In the following sections, we outline some tips and address common questions for specific types of apps:

1. For product recommendations and upselling, search apps and page builders

2. For loyalty and rewards apps

3. For email, SMS and push notifications apps

4. For SEO apps

5. For shipment tracking apps


1. For product recommendations and upselling, search apps and page builders

If you want to display Judge.me widget information (stars, aggregate ratings, review count, carousel, specific product reviews, etc.) as part of your own widget appearing on the merchant’s front end, we recommend you use the cached version of the Judge.me widgets by making a request to our cache server. It’s not only faster than using Judge.me API but also allows multiple widgets to be loaded in a single request. Check this FAQ to see an example of how to get the aggregate ratings using our cache server.


2. For loyalty and rewards apps

If you want to get our review information to perform a specific action (such as sending a reward coupon when a review is submitted and meets specific conditions), you can create webhooks on your side to pull information from us. When a new review is submitted, we will check whether the shop enables reward integration or not.

  • If the shop doesn’t enable any integration, we'll use our internal coupon system.

  • If the shop enables one integration, we check which reward integration they are using and send review information to your system.


3. For email, SMS and push notifications apps

If you are email, SMS, or push notification apps, please contact us at support@judge.me for more details because the integration will be done on our side. Specifically, we will make an API request to your server to send an email, SMS message, or push notification with the content and recipient of the review request.


4. For SEO apps

If you want to get our schema markup to display product reviews in rich snippets, please add these three lines of code in the products' snippet:


{%- if product.metafields.judgeme -%}

"@id": {{ canonical_url | append: '#product' | json }},

{%- endif -%}

*Note: the #product after @id is optional.


In general, your JSON-LD script needs to have an @id. Our app will detect the @id of your script and replicate it to merge our AggregateRating with the rest of your script. The integration will link your JSON-LD product snippets with our JSON-LD review snippets, helping your users to show ratings in organic search.


5. For shipment tracking apps

If you are a shipment tracking app, you can let the users send review requests based on order delivery dates (instead of order fulfillment dates) by updating the delivery status directly to Shopify. Once the users install your shipment tracking app and enable our Delivery-based request feature in Judge.me, we will schedule review requests once the order is marked as delivered in Shopify. At the moment, we prefer this method and once you update to Shopify, other apps can also use this data.