Developer changelog

Shopify is retiring gates types and fields in favour of metafields and metaobjects for better custom data management across Admin, Storefront, and Functions APIs.

Shopify's GraphQL now supports retrieving Shop Pay payment details using source_identifier or receipt token, streamlining workflows for merchants using Shop Component.

Display customer store credit on storefront using the new store_credit_account object via customer.store_credit_account.balance.

API version 2025-07 deprecates the draftOrderCreateMerchantCheckout mutation.

We’ve added new automated checks to the Shopify App Store review process to help you prepare your app for submission, provide faster feedback, and prevent common errors.

Starting April 29, 2025, payment apps can no longer be embedded in the Shopify admin.

Display a modal after purchase with the new paymentSessionModal mutation.

Developers will continue to enjoy a revshare exemption on the first $1 million USD of lifetime revenue, and a 15% share on amounts above that.

event.data.checkout.subtotalPrice.amount on the new /thank-you page now sums line item prices after product and order discounts, aligning with the old /thank_you page.

The publicDisplayName field is added to ShopPlan. The Shopify plan is now Grow. Update to publicDisplayName as displayName will be deprecated.

The release candidate for version 2025-07 of the Storefront, GraphQL Admin, and Customer Account APIs now support imperial units and count measurements, enabling more transparent pricing.

In the POS UI Extensions Cart API, some Customer fields have been removed from the subscribable hook. To get this data, developers can query the customer by customerId.

Automatically create smart collections with the new PRODUCT_CATEGORY_ID_WITH_DESCENDANTS field.

productSet mutation returns more precise PRODUCT_SUSPENDED error code

Inventory Transfers developer preview is now available, allowing you to test enhanced multi-location inventory management features and build integrations for complex inventory movements.

Starting May 12th Shopify's store editor will include an opacity slider for theme colors. Update Liquid and CSS to handle transparency with rgba and color-mix for seamless integration.

The GraphQL Storefront API now supports setting cart attributes with blank keys or values, aligning with the AJAX API's behavior.

App ratings now factor in trust signals, with reviews from lower-trust shops carrying less weight.

Stable API versions now retroactively add GraphQL Enum values. Refresh introspection caches and implement catch-alls to avoid toolchain disruptions.

We've added new FulfillmentOrderRejectionReason enum values for more detailed error messages.

@inContext directive added to the 2025-04 version of the Customer Account API to help integrate with international markets

As of API version 2025-04 of the GraphQL Admin API, the productSet and customerSet mutations can upsert by identifier, simplifying record management.

Renamed NewTextFieldProps to TextFieldProps. Added support for transaction complete, cash tracking, and receipt footer targets. Introduced POSReceiptBlock component for receipt footer.

Payment session payloads now include ISO 3166-2 province codes (e.g., "QC") for consistent regional handling. Available in API v2025-07+. Existing apps remain unaffected.

Added new enum values to CustomerPaymentMethodRevocationReason: CUSTOMER_REDACTED, TOO_MANY_CONSECUTIVE_FAILURES, CVV_ATTEMPTS_LIMIT_EXCEEDED

The themeFilesUpsert mutation now returns theme file metadata directly, eliminating the need for extra fetch requests to verify updates.

Shopify-approved finance apps can access shop finance details and subscribe to related webhooks

Added rfmGroup field to customer statistics in the Admin GraphQL Admin API to expose customer segmentation data based on purchasing patterns.

The draftOrderCount query is now available in the 2025-07 stable version of the GraphQL Admin API. Previously, it was...

You can now remove cart and checkout attributes by passing the attribute key you wish to remove with the AttributeRemoveChange property.

The Payments Apps API now supports AVS and CVV details for card-not-present transactions.

location.id can now be queried with read_inventory or read_locations scopes. Other Location fields still need read_locations. Applies to all API versions.

Order status URLs now use capability tokens instead of static keys, improving security with limited uses and automatic expiration. Optional parameters available for customization.

Use the giftCardConfiguration query to retrieve the maximum values for purchased and issued gift cards.

Use this webhook to learn when your users have upgraded their Thank you and Order status pages.

API v2025-04 adds fulfillmentStatus to Order, showing the order's overall fulfillment status for display.

To fetch a list of article authors for a store, use the new articleAuthors query.

articles, pages, and comments queries now have full filter parity with the REST Admin API

Developer Preview: Serve your app on localhost with a self-signed HTTPS certificate using Shopify CLI.

Webhook scopes for InventoryItem are now flexible, allowing read_inventory or read_products for INVENTORY_ITEMS_CREATE, DELETE, UPDATE across all API versions.

How Retail Ship and carry out orders will impact the behaviour of order and fulfillment order objects

Locations can now be used in delivery promise participant queries and mutations in the unstable GraphQL Admin API, with full release in 2025-07. Filter products by delivery promise participants.

Hydrogen v2025.1.3 adds support for Vite 6 and enables the v3_routeConfig future flag for Remix.

Apps will see an improved visual appearance of the App Bridge Title Bar API starting to rollout, to match the new...

App subscription plans now include persistent plan handles, making it easier to query for plan data.

Version 2025-07 of the GraphQL Storefront API improves error handling for selling plans. Cart mutations now specify errors for missing or inapplicable selling plans.

Liquid now supports OKLCH colors, enabling a broader color range. New features include color_to_oklch filter and enhanced color object properties for OKLCH.

The GraphQL and REST Admin API now support various customer-related search terms that were disabled in API version 2024-07. For example: accepts_marketing, city, company, and more.

Draft orders inactive for a year will auto-delete starting April 1, 2026 to improve data management and app performance. Applies to orders created after April 1, 2025.

The 2025-04 Admin API allows custom identifier lookup for collections, locations, orders, and product variants.