New Features
Optional Consent
Users can now reject scopes and continue using your Mini. Consent is no longer all-or-nothing — if a user declines a scope, your Mini should gracefully degrade rather than block the experience. If your Mini hard-fails when a scope is rejected, please update it using the new hooks below.
useCheckScopesConsent Hook
Check at runtime which scopes a user has granted. Use this to conditionally render features that depend on a particular scope.
Usage:
import {useCheckScopesConsent} from '@shopify/shop-minis-react'
function MyMini() {
const {scopes} = useCheckScopesConsent()
if (scopes.includes('product_lists:write')) {
return <SaveToListButton />
}
return <SignInPrompt />
}
useRequestScopesConsent Hook
Re-request consent after a user has previously declined. The hook must be invoked from a user interaction — you cannot re-prompt automatically. Use this for flows where granting consent unlocks a clear, user-initiated action.
Usage:
import {useRequestScopesConsent} from '@shopify/shop-minis-react'
function GrantAccessButton() {
const {requestScopesConsent} = useRequestScopesConsent()
return (
<button onClick={() => requestScopesConsent(['product_lists:write'])}>
Enable saving products
</button>
)
}
useCheckPermissions Hook
Separate from scopes, useCheckPermissions lets your Mini check OS-level permissions (camera, photo library, and so on) before invoking an action that requires them.
Usage:
import {useCheckPermissions} from '@shopify/shop-minis-react'
function CameraFeature() {
const {permissions} = useCheckPermissions(['camera'])
if (permissions.camera === 'granted') {
return <CameraView />
}
return <RequestCameraButton />
}
request_blocked Sentinel
When a user has declined a scope or permission and the platform will not re-prompt, the relevant hooks now return a request_blocked sentinel value instead of null. This lets you distinguish "not asked yet" from "asked and blocked" and tailor your UI accordingly. See the Scopes Consent docs on shopify.dev for the full state machine.
Intents
Intents are a new communication layer between the Shop app and Shop Minis. The Shop app launches your Mini from contextually relevant moments — such as a product detail page — and passes along the context (typically a product). For partners, this opens a new path to distribution: instead of relying on the Explore tab alone, your Mini can be surfaced where buyer intent is highest.
Two intents are supported today:
| Intent | What it's for | | :
