Developer changelog

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 1st 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.

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.

MCP server for Shopify dev assistant

Shopify Exchange Platform now supports Retail Exchanges, consolidating operations into a single Return. Update integrations for unified sales agreements. ExchangeV2 APIs deprecated in 1 year.

Shopify App Store now supports mobile ads and targeting on homepage and category page ads. Set bid prices for devices and access detailed mobile ad reports via Ads Manager in your Partner Dashboard.

Starting from 2025-04, unused PriceListErrorCode values will be removed.

JS Buy SDK v3.0 is now available

As of GraphQL Admin API version 2025-04, the defaultPhoneNumber field is introduced on the Customer object to support querying a customer's phone number and marketing state.

Learn more...

As of GraphQL Admin API version 2025-04, the defaultEmailAddress field is introduced on the Customer object to support querying a customer's email address and marketing state.

Learn more...

Shopify API 2025.04 ends support for specific POS UI Extension versions. Update to the latest version to ensure functionality with POS 9.31 and beyond.

New Shopify Collective docs offer guidance on integrating systems using Shopify's API and webhooks, enhancing workflow integration for developers.

In POS version 9.30, the POS UI Extensions modal will be enhanced to prevent accidental dismissals. You won't be able to dismiss the modal by swiping down or tapping outside of it. This update is...

As of the 2025-04 API version, the OrderEditAddVariant API will adhere to the pricing configurations set for Markets and Company Locations.

Updated AJAX API error messages for inventory requests: "Only available quantity added" and "Max quantity in cart." Affects add.js, change.js, and update.js endpoints.

Introducing the .dev Assistant extension for VSCode, enhancing your development workflow directly in the editor for improved efficiency.