To provide full functionality, Judge.me requests specific permissions during installation. These permissions allow us to send review requests, display widgets, verify buyer status, and more. Shopify has reviewed and approved Judge.me for the permissions that require their validation.
You can read more in Shopify’s official guide to app permissions.
Base scopes
Shopify scope | Permission details | Why we need it |
read_all_orders | Read all past and future orders | Needed to import full order history for review request emails and verified buyer checks |
read_orders | Read order data | Core scope for accessing order details — used for review requests, order syncing, and verified buyer logic |
read_customers | Read customer data | Look up customer information for reviewer identification, verified buyer checks, and customer account validation |
write_products | Write product data (including metafields) | Write review-related metafields to products (e.g. star ratings, review counts displayed on storefronts) |
read_marketing_events | Read marketing events | Required for Shopify marketing event integration |
write_marketing_events | Create/update marketing events | Track and report marketing activities (e.g. review request campaigns) |
read_price_rules | Read price rules | Read existing discount price rules for coupon-based review incentives (legacy approach before Discounts API) |
write_price_rules | Create/update price rules | Create discount codes as review incentives via the legacy Price Rules API |
read_content | Read pages, blogs, articles | Access shop content for widget integration and page-level review features |
write_content | Write pages, blogs, articles | Create/update content pages (e.g. all-reviews page integration) |
read_themes | Read theme files | Read theme templates to detect widget placement, check liquid code, and display theme info |
Additional scopes
Shopify scope | Permission details | Why we need it |
read_metaobjects | Read metaobject definitions and entries | Read review-related metaobjects synced to Shopify's native product reviews infrastructure |
write_product_reviews | Write product review data via Shopify's native API | Sync reviews as Shopify native product reviews (metaobjects), enabling them in Shopify-native surfaces like Shop app |
read_locales | Read shop locales | Fetch the shop's available languages/locales for multi-language widget support |
read_translations | Read translated content | Read existing translations for settings and widget content |
write_translations | Write translated content | Push translated widget settings to the storefront for multi-locale shops |
write_customers | Create/update customer records and tags | Sync reviewer data back to Shopify customers — tag customers based on review activity |
read_returns | Read return/refund data | Subscribe to returns/request and returns/approve webhooks to suppress review requests for returned orders |
customer_read_orders | Read orders via customer account API | Validate verified buyer status when reviews are submitted through Shopify's customer account extensions |
customer_read_customers | Read customer data via customer account API | Authenticate and validate customer identity in customer account review flows |
read_pixels | Read web pixel configurations | Check existing web pixel setup on the shop |
write_pixels | Create/update web pixels | Install Judge.me's web pixel for storefront analytics and event tracking |
read_customer_events | Read customer browser events | Capture storefront customer events (page views, cart actions) through the web pixel for analytics |
read_discounts | Read discount codes/automatic discounts | Read existing Shopify discounts to avoid conflicts and check coupon status |
write_discounts | Create/update discounts | Create discount codes via Shopify's modern Discounts API (replaces legacy Price Rules) for review incentive coupons |
write_themes | Modify theme files | Programmatically install/update widget snippets in theme Liquid files |