---
title: >-
  Expiring offline access tokens required for new custom apps as of December 1,
  2026 - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/expiring-offline-access-tokens-required-for-new-custom-apps-as-of-december-1-2026
  md: >-
    https://shopify.dev/changelog/posts/expiring-offline-access-tokens-required-for-new-custom-apps-as-of-december-1-2026.md
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: Admin REST API
      handle: admin-rest
    - displayName: GraphQL Admin API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-11-18T15:22:49-05:00'
  postedAt: '2026-11-19T12:00:00-05:00'
  updatedAt: '2026-11-19T16:14:04-05:00'
  effectiveAt: '2026-11-19T12:00:00-05:00'
---

November 19, 2026

# Expiring offline access tokens required for new custom apps as of December 1, 2026

DateNovember 19, 2026

FlagsUpdate

Tags[Admin REST API](https://shopify.dev/changelog?api_type=admin-rest)[GraphQL Admin API](https://shopify.dev/changelog?api_type=admin-graphql)

Starting December 1, 2026, every new custom app must request and use expiring [offline access tokens](https://shopify.dev/docs/apps/build/authentication-authorization/access-tokens#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=1` in your token request and then storing and using the refresh token that Shopify returns.
* Tokens that you obtain through the [client credentials grant](https://shopify.dev/docs/apps/build/authentication-authorization/client-credentials-grant?lang=node) already expire after 24 hours, so this flow already meets the requirement.
* Tokens that you obtain through [application-only access](https://shopify.dev/docs/apps/build/authentication-authorization/application-only-access-tokens) 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

1. If your app uses token exchange or the authorization code grant:

   * Include `expiring=1` in 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.

2. 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](https://shopify.dev/docs/apps/build/authentication-authorization/access-tokens#offline-access-tokens).
