Starting December 1, 2026, every new custom app must request and use expiring offline access tokens for GraphQL Admin API and REST Admin API requests. This has been required for new public apps since April 1, 2026. This update extends the requirement to new partner-created custom apps and merchant-created apps.
If you already request expiring offline tokens, you likely don’t need to change your app.
What changed
For apps created on or after December 1, 2026, Shopify requires expiring offline access tokens for Admin API calls:
- New offline tokens that you obtain with the authorization code grant or token exchange must be expiring.
- You request an expiring offline token by including
expiring=1in your token request and then storing and using the refresh token that Shopify returns. - Tokens that you obtain through the client credentials grant already expire after 24 hours, so this flow already meets the requirement.
- Tokens that you obtain through application-only access already meet the requirement.
Existing custom apps and merchant-created apps that were set up before December 1, 2026 can keep using their existing offline tokens.
Who’s affected
The requirement for expiring offline access tokens applies to:
- Custom apps created on or after December 1, 2026
- Apps that merchants create on or after December 1, 2026
The following aren’t affected by this change:
- Custom apps and merchant-created apps that were created before December 1, 2026
- Public apps, which have already been required to use expiring offline tokens since April 1, 2026
Why this matters
Expiring offline access tokens limit how long a leaked token can be used. If an expiring token leaks, it stops working after a fixed amount of time unless your app refreshes it. A non-expiring token keeps working until the app is uninstalled or you rotate the app secret, which increases the risk from a leak.
What to do
If your app uses token exchange or the authorization code grant:
- Include
expiring=1in your token requests for offline access. - Store and use the refresh token that Shopify returns to obtain new access tokens when the current one expires.
- If you use Shopify app templates or libraries, check that you’re on a recent version, because they already request expiring tokens by default.
- Include
If your app uses the client credentials grant:
- You don’t need to make any changes. Tokens from that grant already expire after 24 hours.
For setup details and examples, see the expiring offline access token guide in the Admin API docs: Use expiring offline access tokens.