---
title: >-
  Stable GraphQL API versions to backfill enum values - 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/stable-graphql-api-versions-to-backfill-enum-values
  md: >-
    https://shopify.dev/changelog/stable-graphql-api-versions-to-backfill-enum-values.md
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Payments Apps API
      handle: payments-apps-api
    - displayName: Storefront GraphQL API
      handle: storefront-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2025-04-01T14:36:23-04:00'
  postedAt: '2025-04-01T12:00:00-04:00'
  updatedAt: '2025-04-01T16:41:44-04:00'
  effectiveAt: '2025-04-02T12:00:00-04:00'
---

April 1, 2025

Tags:

* Admin GraphQL API
* Payments Apps API
* Storefront GraphQL API

# Stable GraphQL API versions to backfill enum values

Our stable API versions will retroactively add values into GraphQL Enum types, making them non-exhaustive going forward. This assures that new application data values can be represented in older API versions, which provides better stability.

While this is a non-breaking change, it can cause disruptions to development toolchains. We recommend that you periodically refresh introspection caches, and integrate enums into your application logic with a catch-all that anticipates unknown cases.

For more information, see <https://shopify.dev/docs/api/usage/versioning#stable-api-versions>.