Shop Minis Introduces Optional Consent Model

Shopify has updated Shop Minis to support optional consent, allowing users to reject specific permission scopes while continuing to use a Mini. This replaces the previous all-or-nothing consent model that required users to grant all requested permissions or abandon the experience entirely.

What Changed

The update introduces a new useCheckScopesConsent hook that lets developers check at runtime which scopes a user has granted. Developers can now build Minis that conditionally render features based on available permissions rather than blocking the entire experience when users decline certain scopes.

Shopify requires developers to update Minis that currently hard-fail when users reject scopes. The platform expects Minis to degrade gracefully, maintaining core functionality even when optional permissions are denied.

Developer Impact

This change affects how Shop Mini developers handle permission requests and feature availability. Developers need to implement conditional logic using the new hook to check scope status before rendering permission-dependent features.

The shift to optional consent means developers must identify which features require specific scopes and build fallback experiences for users who decline those permissions. This requires rethinking Mini architecture to separate core functionality from permission-dependent features.

Implementation Requirements

Developers should audit existing Minis to identify hard failures related to rejected scopes. The useCheckScopesConsent hook provides the mechanism to query granted permissions and adjust the user interface accordingly. Minis that block users for declining non-essential scopes need updates to comply with the new consent model.

Read the full announcement →