--- title: Recent changes to Shopify’s platform 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?api_version=2025-10 md: https://shopify.dev/changelog.md?api_version=2025-10 --- # Developer changelog Subscribe to the changelog to stay up to date on recent changes to Shopify’s APIs and other developer products, as well as preview upcoming features and beta releases. [RSS Updates](https://shopify.dev/changelog/feed.xml) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [`multipassIdentifier` field added to GraphQL Admin API](https://shopify.dev/changelog/multipassidentifier-field-added-to-graphql-admin-api) The multipassIdentifier field is now available in the Admin GraphQL API for customerCreate and customerUpdate mutations, providing feature parity with the REST Admin API. [Read full post –>](https://shopify.dev/changelog/multipassidentifier-field-added-to-graphql-admin-api) * October 1, 2025 Tags: * Functions * 2025-10 ### [Introducing `functionHandle` for Shopify Functions](https://shopify.dev/changelog/introducing-functionhandle) Shopify Functions now support user-defined handles in GraphQL mutations, simplifying deployment by removing the need to query for functionId. Existing functionId usage remains supported. [Read full post –>](https://shopify.dev/changelog/introducing-functionhandle) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New: Support for USDC Credit field in Shopify Payments Payout GraphQL](https://shopify.dev/changelog/new-support-for-usdc-credit-field-in-shopify-payments-payout-graphql) GraphQL Admin API 2025-10 adds `usdcRebateCreditAmount` to ShopifyPaymentsPayoutSummary, providing a total of all usdc rebate credits issued as part of the payout. [Read full post –>](https://shopify.dev/changelog/new-support-for-usdc-credit-field-in-shopify-payments-payout-graphql) * October 1, 2025 Tags: * Storefront GraphQL API * 2025-10 ### [Storefront API Cart now supports adding Gift Cards](https://shopify.dev/changelog/storefront-api-cart-now-supports-adding-gift-cards) As of version 2025-10 of the GraphQL Storefront API, Cart now supports adding gift cards without replacing already applied gift cards. [Read full post –>](https://shopify.dev/changelog/storefront-api-cart-now-supports-adding-gift-cards) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Rerouting Fulfillment Orders is now possible via API](https://shopify.dev/changelog/rerouting-fulfillment-orders-via-api) The `fulfillmentOrdersReroute` mutation in the Admin GraphQL API lets developers reroute orders based on delivery strategies, enhancing flexibility and consistency. [Read full post –>](https://shopify.dev/changelog/rerouting-fulfillment-orders-via-api) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Subscription contract shipping requirements now sync with product variants](https://shopify.dev/changelog/subscription-contract-shipping-requirements-now-sync-with-product-variants) Subscription contracts now sync shipping requirements from product variants and skip delivery lines for digital orders, ensuring accurate taxes and totals. [Read full post –>](https://shopify.dev/changelog/subscription-contract-shipping-requirements-now-sync-with-product-variants) * October 1, 2025 Tags: * Tools * 2025-10 ### [Polaris unified web components are now stable](https://shopify.dev/changelog/polaris-unified-web-components-are-now-stable) Polaris web components are now generally available, supporting Admin, Checkout, Customer Accounts, and POS surfaces via Shopify's CDN. [Read full post –>](https://shopify.dev/changelog/polaris-unified-web-components-are-now-stable) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New `productNetwork` field on the `Order` object](https://shopify.dev/changelog/new-productnetwork-field-on-order-object) The Order object now includes a productNetwork boolean field (2025-10) to identify orders created through the Product Network. [Read full post –>](https://shopify.dev/changelog/new-productnetwork-field-on-order-object) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [`productSet` mutation now validates `inventoryQuantities` limits](https://shopify.dev/changelog/productset-limit-for-inventory-quantities) The `productSet` mutation now enforces validation limits on inventory quantities as part of supporting the increased variant limit from 100 to 2048 variants per product. [Read full post –>](https://shopify.dev/changelog/productset-limit-for-inventory-quantities) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Dynamic complexity cost for `productCreate` and `productUpdate` mutations](https://shopify.dev/changelog/dynamic-complexity-cost-for-productcreate-and-productupdate-mutations) The `productCreate` and `productUpdate` mutations now use dynamic complexity costing that more accurately reflects the actual computational cost of operations. [Read full post –>](https://shopify.dev/changelog/dynamic-complexity-cost-for-productcreate-and-productupdate-mutations) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [`productVariantsBulkCreate` and `productVariantsBulkUpdate` mutations now validate `inventoryQuantities` limits](https://shopify.dev/changelog/inventoryquantities-limit-in-mutations) The `productVariantsBulkCreate` and `productVariantsBulkUpdate` mutations now validate limits on inventory quantities to support increased variant limit from 100 to 2048 variants per product. [Read full post –>](https://shopify.dev/changelog/inventoryquantities-limit-in-mutations) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Dynamic complexity cost for `productSet` mutation](https://shopify.dev/changelog/dynamic-complexity-cost-for-productset-mutation) The `productSet` mutation now uses dynamic complexity costing that more accurately reflects the actual computational cost of operations. [Read full post –>](https://shopify.dev/changelog/dynamic-complexity-cost-for-productset-mutation) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [ShopifyQL now available as `shopifyqlQuery` within the GraphQL Admin API](https://shopify.dev/changelog/shopifyqlquery-now-available-in-graphql-admin-api) Adds query field `shopifyqlQuery` to GraphQL Admin API [Read full post –>](https://shopify.dev/changelog/shopifyqlquery-now-available-in-graphql-admin-api) * October 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Duplicate themes with the Admin GraphQL API](https://shopify.dev/changelog/duplicate-themes-with-the-admin-graphql-api) The new `themeDuplicate` mutation in Admin GraphQL API allows you to duplicate themes (and optionally rename the duplicate). [Read full post –>](https://shopify.dev/changelog/duplicate-themes-with-the-admin-graphql-api) * September 23, 2025 Tags: * Admin GraphQL API * Liquid * Storefront GraphQL API * 2025-10 ### [New metafield definition types in GraphQL - article\_reference / list.article\_reference](https://shopify.dev/changelog/new-metafield-definition-types-in-graphql-articlereference-listarticlereference) Shopify's Admin GraphQL API now supports `article_reference` and `list.article_reference` metafield types, enabling dynamic content linking and improved store customization. [Read full post –>](https://shopify.dev/changelog/new-metafield-definition-types-in-graphql-articlereference-listarticlereference) * September 17, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New `mandate` connection added to `CustomerPaymentMethod` object](https://shopify.dev/changelog/new-mandate-connection-added-to-customerpaymentmethod-object) API v2025-10: Apps with read\_customer\_payment\_methods scope can now query the mandate connection on CustomerPaymentMethod to access payment method authorizations via resourceType and resourceId. [Read full post –>](https://shopify.dev/changelog/new-mandate-connection-added-to-customerpaymentmethod-object) * September 17, 2025 Tags: * Admin GraphQL API * Customer Account API * 2025-10 ### [New balance and due status fields for PaymentSchedule](https://shopify.dev/changelog/new-balance-and-due-status-fields-for-paymentschedule) You can now access more detailed balance information and due status for payment schedules with three new fields: balanceDue, totalBalance, and due. [Read full post –>](https://shopify.dev/changelog/new-balance-and-due-status-fields-for-paymentschedule) * September 16, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Order metafield definitions and values can now be used as filters in the Shopify Admin UI](https://shopify.dev/changelog/order-metafield-definitions-and-values-can-now-be-used-as-filters-in-the-shopify-admin-ui) Order metafield filters in Shopify Admin UI and GraphQL API enhance order management, allowing precise data retrieval and improved operational efficiency for developers and merchants. [Read full post –>](https://shopify.dev/changelog/order-metafield-definitions-and-values-can-now-be-used-as-filters-in-the-shopify-admin-ui) * September 15, 2025 Tags: * Admin GraphQL API * Customer Account API * 2025-10 ### [Store credit now supports company locations as account owners in Admin and Customer APIs](https://shopify.dev/changelog/store-credit-now-supports-company-locations-as-account-owners-in-admin-and-customer-apis) Store credit accounts now support company locations, enabling location-specific credit management. B2B customers can view and use credits at checkout. APIs updated for credit queries and transactions. [Read full post –>](https://shopify.dev/changelog/store-credit-now-supports-company-locations-as-account-owners-in-admin-and-customer-apis) * September 12, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New enum values for FulfillmentEventStatus](https://shopify.dev/changelog/new-carrier-picked-up-fulfillment-status) The `FulfillmentEventStatus` enum now includes `CARRIER_PICKED_UP`, allowing merchants to track when carriers collect shipments. [Read full post –>](https://shopify.dev/changelog/new-carrier-picked-up-fulfillment-status) * September 10, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Metaobject field definitions offer new capabilities](https://shopify.dev/changelog/metaobject-field-capabilities) Version 2025-10 allows metaobject fields to include capabilities like `admin_filterable`, enabling filtering in Shopify admin. [Read full post –>](https://shopify.dev/changelog/metaobject-field-capabilities) * September 5, 2025 Tags: * Action Required * Admin GraphQL API * Admin REST API * 2025-10 ### [Setting `permitsSkuSharing` argument to `false` when creating a fulfillment service returns an error](https://shopify.dev/changelog/setting-permitsskusharing-argument-to-false-when-creating-a-fulfillment-service-returns-an-error) The 2025-10 API update returns an error on `false` for `permitsSkuSharing` in `fulfillmentServiceCreate` and `FulfillmentService#create`, deprecating non-SKU sharing services. [Read full post –>](https://shopify.dev/changelog/setting-permitsskusharing-argument-to-false-when-creating-a-fulfillment-service-returns-an-error) * September 2, 2025 Tags: * Storefront GraphQL API * 2025-10 ### [`@inContext` directive supports visitor consent for privacy-compliant checkouts](https://shopify.dev/changelog/incontext-directive-supports-visitor-consent-for-privacy-compliant-checkouts) The `@inContext` directive now supports `visitorConsent` for buyer preferences, auto-encoding consent into `checkoutUrl`, ensuring privacy compliance in Storefront API v2025-10+. [Read full post –>](https://shopify.dev/changelog/incontext-directive-supports-visitor-consent-for-privacy-compliant-checkouts) * September 1, 2025 Tags: * Action Required * Admin GraphQL API * 2025-10 ### [CollectionReorderProducts operation userErrors now includes code field](https://shopify.dev/changelog/collectionreorderproducts-operation-usererrors-now-includes-code-field) In version 2025-10, `collectionReorderProducts` mutation's `userErrors` type changes to `CollectionReorderProductsUserError`, adding a `code` field for enhanced error handling. [Read full post –>](https://shopify.dev/changelog/collectionreorderproducts-operation-usererrors-now-includes-code-field) * September 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Global HS code is now supported in GraphQL Admin API](https://shopify.dev/changelog/country-hs-codes-global-value) As of `2025-10`, set `countryCode` in `CountryHarmonizedSystemCodeInput` to `null` to set a global harmonized system code. [Read full post –>](https://shopify.dev/changelog/country-hs-codes-global-value) * August 29, 2025 Tags: * Storefront GraphQL API * 2025-10 ### [Cart mutations now return error for invalid merchandise configuration](https://shopify.dev/changelog/storefront-api-cart-now-exposes-invalid-merchandise-configuration-error) Cart mutations now return a `MERCHANDISE NOT APPLICABLE` error for invalid merchandise configurations. [Read full post –>](https://shopify.dev/changelog/storefront-api-cart-now-exposes-invalid-merchandise-configuration-error) * August 25, 2025 Tags: * Webhook * 2025-10 ### [Enhanced delivery profile webhooks now include additional payload fields](https://shopify.dev/changelog/enhanced-delivery-profile-webhooks-now-include-additional-payload-fields) The `profiles/update` webhook now includes fields like `name`, `default`, `profile_type`, and `version`, improving update reliability and reducing debouncing for rapid profile changes. [Read full post –>](https://shopify.dev/changelog/enhanced-delivery-profile-webhooks-now-include-additional-payload-fields) * August 21, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New PRESERVE\_STANDALONE\_VARIANT strategy for the productVariantsBulkCreate mutation](https://shopify.dev/changelog/new-preservestandalonevariant-strategy-for-productvariantsbulkcreate-mutation) New ProductVariantsBulkCreateStrategy to enhance productVariantsBulkCreate capabilities [Read full post –>](https://shopify.dev/changelog/new-preservestandalonevariant-strategy-for-productvariantsbulkcreate-mutation) * August 18, 2025 Tags: * Action Required * Admin GraphQL API * 2025-10 ### [Introducing the new `context` field to specify discount eligibility](https://shopify.dev/changelog/discount-eligibility-management) We’ve introduced a new context field to specify discount eligibility code and automatic discounts. The context field replaces the now deprecated DiscountCustomerSelection field for code discounts. [Read full post –>](https://shopify.dev/changelog/discount-eligibility-management) * August 8, 2025 Tags: * Admin GraphQL API * 2025-10 ### [`webhookSubscriptionCreate` and `webhookSubscriptionUpdate` support all URI types](https://shopify.dev/changelog/consolidate-webhook-graphql-surfaces) Webhook GraphQL mutations now support a `uri` field for all address types, deprecating specific endpoint mutations. `webhookSubscriptions` query adds `uri` filtering; `callbackUrl` is deprecated. [Read full post –>](https://shopify.dev/changelog/consolidate-webhook-graphql-surfaces) * August 8, 2025 Tags: * Action Required * Storefront GraphQL API * 2025-10 ### [The `cartDeliveryAddressesUpdate` mutation now supports removing all addresses from a cart](https://shopify.dev/changelog/the-cartdeliveryaddressesupdate-mutation-now-supports-removing-all-addresses-from-a-cart) To clear all delivery addresses associated with a cart, call the `cartDeliveryAddressesUpdate` mutation and set `addresses` to an empty array. [Read full post –>](https://shopify.dev/changelog/the-cartdeliveryaddressesupdate-mutation-now-supports-removing-all-addresses-from-a-cart) * August 6, 2025 Tags: * Functions * Checkout UI * Customer Account API * Customer Accounts * Liquid * Storefront GraphQL API * Webhook * 2025-10 ### [New: Support for nested cart lines](https://shopify.dev/changelog/new-support-for-nested-cart-lines) New fields have been introduced to enable parent-child (nested) relationships between cart lines, supporting use cases such as warranties, engravings, and gift-wrapping. [Read full post –>](https://shopify.dev/changelog/new-support-for-nested-cart-lines) * August 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Orders query now supports `current_total_price` and `total_weight` filters and `CURRENT_TOTAL_PRICE` as a `sortKey`](https://shopify.dev/changelog/orders-query-now-supports-currenttotalprice-and-totalweight-filters-and-currenttotalprice-as-a-sortkey) The orders query now supports `current_total_price` and `total_weight` filters, plus `sortKey` can use `CURRENT_TOTAL_PRICE`, enhancing data retrieval and sorting options for developers. [Read full post –>](https://shopify.dev/changelog/orders-query-now-supports-currenttotalprice-and-totalweight-filters-and-currenttotalprice-as-a-sortkey) * August 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Shopify Payments Payout GraphQL type supports `external_trace_id`](https://shopify.dev/changelog/shopify-payments-payout-graphql-type-supports-externaltraceid) GraphQL Admin API 2025-10 adds `externalTraceId` to ShopifyPaymentsPayout, providing the financial institution's reference number for payout tracking. [Read full post –>](https://shopify.dev/changelog/shopify-payments-payout-graphql-type-supports-externaltraceid) * July 30, 2025 Tags: * Action Required * Admin GraphQL API * Admin REST API * 2025-10 ### [Deprecation of the `ProductVariant.taxCode` field](https://shopify.dev/changelog/deprecation-of-tax-code-field) The `taxCode` field in `ProductVariant` is deprecated as of API version `2025-10`. Update your app to remove dependencies on this field due to Avalara AvaTax app discontinuation. [Read full post –>](https://shopify.dev/changelog/deprecation-of-tax-code-field) * July 30, 2025 Tags: * Storefront GraphQL API * 2025-10 ### [MerchandiseSellingPlanNotApplicableOnCompanyLocation warning code for Storefront API](https://shopify.dev/changelog/sellingplannotapplicableoncompanylocation-warning-code-for-storefront-api) API version 2025-10 adds MERCHANDISE\_SELLING\_PLAN\_NOT\_APPLICABLE\_ON\_COMPANY\_LOCATION to CartWarningCode, alerting B2B users when a cart includes a selling plan at a company location. [Read full post –>](https://shopify.dev/changelog/sellingplannotapplicableoncompanylocation-warning-code-for-storefront-api) * July 29, 2025 Tags: * Storefront GraphQL API * 2025-10 ### [Storefront API Cart now supports replacing Cart delivery addresses](https://shopify.dev/changelog/storefront-api-cart-now-supports-replacing-cart-delivery-addresses) As of version 2025-10 of the GraphQL Storefront API, you can replace all delivery addresses that are present on a cart in a single operation. The new \[`cartDeliveryAddressesReplace`... [Read full post –>](https://shopify.dev/changelog/storefront-api-cart-now-supports-replacing-cart-delivery-addresses) * July 15, 2025 Tags: * Admin GraphQL API * 2025-10 ### [New fields for inventory shipment timestamps](https://shopify.dev/changelog/inventory-shipment-timestamp-fields) Inventory shipment timestamps are now accessible via the Admin GraphQL API. Use `dateCreated`, `dateReceived`, and `dateShipped` fields. [Read full post –>](https://shopify.dev/changelog/inventory-shipment-timestamp-fields) * July 12, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Add option to filter by dispute type in OrderListQuery GraphQL query](https://shopify.dev/changelog/add-option-to-filter-by-dispute-type-in-order-list) Added `dispute_type` filter to `OrderListData` GraphQL query, enabling filtering of orders by `chargeback` and/or `inquiry`. [Read full post –>](https://shopify.dev/changelog/add-option-to-filter-by-dispute-type-in-order-list) * June 30, 2025 Tags: * Action Required * Admin GraphQL API * 2025-10 ### [Removed tax-related fields from the `ShopFeatures` object](https://shopify.dev/changelog/removed-tax-related-fields-from-the-shopfeatures-object) The `EligibleForShopifyTaxReporting` and `ShopifyTaxReportingLegacyAutoTaxMigrated` fields are removed from `ShopFeatures`. Update integrations as no replacements exist. [Read full post –>](https://shopify.dev/changelog/removed-tax-related-fields-from-the-shopfeatures-object) * June 29, 2025 Tags: * Admin GraphQL API * Liquid * Storefront GraphQL API * 2025-10 ### [Image alt text can now be translated](https://shopify.dev/changelog/mark-image-alt-text-as-translatable) Image alt text is now translatable, allowing developers to register translations via the Translations API. [Read full post –>](https://shopify.dev/changelog/mark-image-alt-text-as-translatable) * June 19, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Order editing workflows now offer direct session access via mutation arguments and return fields](https://shopify.dev/changelog/order-editing-workflows-now-offer-direct-session-access-via-mutation-arguments-and-return-fields) API version 2025-10 improves order editing with direct session access via `OrderEditSession.id`, flexible mutation ID support, and enhanced return fields for better workflow tracking. [Read full post –>](https://shopify.dev/changelog/order-editing-workflows-now-offer-direct-session-access-via-mutation-arguments-and-return-fields) * June 1, 2025 Tags: * Admin GraphQL API * 2025-10 ### [Contextual pricing and publishing APIs use backup region fallback](https://shopify.dev/changelog/contextual-pricing-and-publishing-apis-use-backup-region-fallback) API version 2025-10 changes fallback for pricing and publishing to use `backupRegion` settings, ensuring consistency across APIs. Previous versions use store defaults. [Read full post –>](https://shopify.dev/changelog/contextual-pricing-and-publishing-apis-use-backup-region-fallback)