Why integrate with Judge.me?
By building an integration with Judge.me, you enhance your product's capabilities, deliver greater value to merchants, and create a better experience for our shared users. Our fully customizable product review platform supports powerful features, including unlimited reviews, advanced widgets, seamless integrations, and multilingual support.
Integration prerequisites
Before you dive in, here are a few important things to keep in mind:
All integrations go through a quick testing and verification process before they’re officially promoted.
For the best security and user experience, we strongly recommend using OAuth to authenticate your integration and only request the permissions you need.
Some integrations are only available on our Awesome plan, so make sure to check what's included.
Steps to build an integration with Judge.me
Step 1: Choose your integration category
We offer tailored guidance for different app types. Use the table below to find where your integration fits:
Category | App Types | Integration Method |
1 | Product recommendations, Upselling, Search & filter, Page builders | |
2 | Rewards, Email marketing, Marketing automation, Storefront notifications | |
3 | SEO tools | |
4 | Shipment tracking | |
5 | Translation apps |
💬 Not listed? Contact partnerships@judge.me for personalized assistance.
Step 2: Develop your integration
Check our API documentation and category-specific integration guidelines to ensure compatibility and best practices.
To access all Judge.me features during development:
Shopify apps:
Create a Shopify development store and get free access to the Awesome plan for testing.WooCommerce and BigCommerce apps:
Enjoy automatic access to the Awesome plan while building your integration.
Need assistance? Email us at partnerships@judge.me with any technical questions. Be sure to include relevant screenshots or screencasts to help us troubleshoot more efficiently.
Step 3: Submit for technical review
Once your integration is ready, please complete the technical review form.
Include testing credentials for our QA team.
Record a demo video (1–2 minutes) with clear, step-by-step instructions to demonstrate:
How your integration works.
How to test its functionality with Judge.me.
Any key flows or edge cases we should be aware of.
Step 4: Promote your integration
After approval, we’ll support you with:
Co-marketing opportunities.
Joint announcements, newsletters, or blog features.
Listing on our integrations directory.
Integration guidelines by app category
1. Product recommendations, upselling, search apps, and page builders
To display review widget content (star ratings, reviews) on your storefront, you have two options:
Cache Server (Awesome plan only):
Optimized for speed (widgets update within minutes).
Loads multiple widgets in one request.
Widget API via cdn.judge.me (Free plan):
Ideal for smaller stores.
May take up to 20 minutes for updates.
2. Rewards, marketing automation, email, and notification apps
To access Judge.me review data:
Set up webhooks to pull relevant events.
Use OAuth to request only necessary permissions (e.g.,
read_reviews
,read_reviewers
).
Example use cases:
Rewards: Trigger points/coupons based on new reviews.
Marketing automation: Trigger flows when reviews are submitted.
Email marketing: Use review details as event data to segment audiences.
Notifications: Display review snippets via in-store pop-ups or banners.
3. SEO apps
To display review stars in Google search results, add the following code to your product’s JSON-LD schema:
{%- if product.metafields.judgeme -%}
"@id": {{ canonical_url | append: '#product' | json }},
{%- endif -%}
This code inserts an @id
into your product’s structured data. Judge.me uses this @id
to link your product information with our AggregateRating schema, allowing product ratings and reviews to appear in search results.
4. Shipment tracking apps
You can get Shopify’s delivery status instead of fetching data from Judge.me.
If merchants are using Judge.me's delivery-based review requests, we'll automatically send requests post-delivery.
5. Translation apps
Judge.me handles most widget translations internally using built-in language support and customizable text settings. As a result, in most cases, your integration won’t need to translate widget content manually.
However, if your app provides on-the-fly translation (e.g., Weglot), it can still be helpful if users need to translate dynamic content in real time as the page loads.
Notes:
Do not translate or modify Shopify metafields that include
judgeme
in their names.These metafields contain HTML code used to render our widgets. Changing them can lead to display errors or unexpected behavior.