--- 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_type=admin-graphql&api_version=2025-01 md: https://shopify.dev/changelog.md?api_type=admin-graphql&api_version=2025-01 --- # 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) * January 1, 2025 Tags: * Admin GraphQL API * Customer Account API * 2025-01 ### [New fields to represent product bundles in a grouped view](https://shopify.dev/changelog/support-bundles-grouped-view-fields-in-graphql-api) We introduced two new fields that allow you to accurately nest component products under the parent product in a grouped view. [Read full post –>](https://shopify.dev/changelog/support-bundles-grouped-view-fields-in-graphql-api) * January 1, 2025 Tags: * Admin GraphQL API * 2025-01 ### [Minimum requirement is now optional on automatic discounts](https://shopify.dev/changelog/minimum-requirement-is-now-optional-on-automatic-discounts) The `minimumRequirement` field in discount APIs is now optional, allowing `null` values. This change simplifies discount setup for merchants in version 2025-01. [Read full post –>](https://shopify.dev/changelog/minimum-requirement-is-now-optional-on-automatic-discounts) * January 1, 2025 Tags: * Admin GraphQL API * 2025-01 ### [New customer input field for the OrderCreate mutation](https://shopify.dev/changelog/new-customer-input-field-for-the-ordercreate-mutation) GraphQL Admin API 2025-01 deprecates `customer_id` for `customer`, allowing direct customer association or upsert, simplifying order creation by removing the need to fetch customer IDs. [Read full post –>](https://shopify.dev/changelog/new-customer-input-field-for-the-ordercreate-mutation) * January 1, 2025 Tags: * Admin GraphQL API * 2025-01 ### [Introduce concatenatedOriginContract to subscriptionLine](https://shopify.dev/changelog/introduce-concatenatedorigincontract-to-subscriptionline) As of 2025-01, we've introduced `concatenatedOriginContract` to `subscriptionLine` . You can now query the origin contract of the lines if you have used the Subscription Billing Cycle APIs to... [Read full post –>](https://shopify.dev/changelog/introduce-concatenatedorigincontract-to-subscriptionline) * January 1, 2025 Tags: * Action Required * Admin GraphQL API * 2025-01 ### [Unused PriceListUserErrorCode values removed](https://shopify.dev/changelog/unused-pricelistusererrorcode-values-removed) Starting from 2025-01, unused `PriceListErrorCode` values will be removed. [Read full post –>](https://shopify.dev/changelog/unused-pricelistusererrorcode-values-removed) * January 1, 2025 Tags: * Admin GraphQL API * 2025-01 ### [New delivery promise participants API](https://shopify.dev/changelog/new-delivery-promise-participants-api) As of the 2025-01 Admin GraphQL API, you can now query for delivery promise participants, using... [Read full post –>](https://shopify.dev/changelog/new-delivery-promise-participants-api) * January 1, 2025 Tags: * Admin GraphQL API * Webhook * 2025-01 ### [Update in orders webhook to view bundles and their components](https://shopify.dev/changelog/update-in-orders-webhook-to-view-bundles-and-their-components) Starting with the Admin API version 2025-01, we have added the `sales_line_item_group_id` field to the orders webhook. This field allows you to determine if a specific `line_item` is part of a... [Read full post –>](https://shopify.dev/changelog/update-in-orders-webhook-to-view-bundles-and-their-components) * January 1, 2025 Tags: * Admin GraphQL API * 2025-01 ### [Combined Listings update mutation error improvements](https://shopify.dev/changelog/combined-listings-update-mutation-error-improvements) Starting with the Admin API version 2025-01, we've introduced new error codes for the `combinedListingUpdate` mutation. These enhancements aim to provide clearer feedback when incorrect data is... [Read full post –>](https://shopify.dev/changelog/combined-listings-update-mutation-error-improvements) * January 1, 2025 Tags: * Action Required * Admin GraphQL API * 2025-01 ### [Fulfillment Hold Access Update For Node Queries](https://shopify.dev/changelog/fulfillment-hold-access-update-for-node-queries) Admin API 2025-01 restricts fulfillment hold access via node queries based on app scopes. Ensure correct scopes to avoid null results when fetching holds. [Read full post –>](https://shopify.dev/changelog/fulfillment-hold-access-update-for-node-queries) * January 1, 2025 Tags: * Admin GraphQL API * 2025-01 ### [BXGY discount support for subscriptions](https://shopify.dev/changelog/bxgy-discount-support-for-subscriptions) BXGY discounts now support subscriptions if X is a subscription and Y is a one-time or free item. Use GraphQL mutations to create/update discounts, specifying item types with input fields. [Read full post –>](https://shopify.dev/changelog/bxgy-discount-support-for-subscriptions) * January 1, 2025 Tags: * Admin GraphQL API * 2025-01 ### [ReverseFulfillmentOrder.order field is nullable as of 2025-01](https://shopify.dev/changelog/reversefulfillmentorder-order-field-is-nullable-as-of-2025-01) As of 2025-01, the ReverseFulfillmentOrder.order field is nullable if the client lacks read\_all\_orders scope and the order is over 60 days old or missing, avoiding graphql errors. [Read full post –>](https://shopify.dev/changelog/reversefulfillmentorder-order-field-is-nullable-as-of-2025-01) * January 1, 2025 Tags: * Admin GraphQL API * 2025-01 ### [Support `Delayed` Fulfillment Status in GraphQL API](https://shopify.dev/changelog/support-delayed-fulfillment-status-in-graphql-api) As of Admin API 2025-01, we have officially introduced a new [fulfillment event status](https://shopify.dev/docs/api/admin-graphql/2024-10/enums/FulfillmentEventStatus) called `delayed`. [Read full post –>](https://shopify.dev/changelog/support-delayed-fulfillment-status-in-graphql-api) * January 1, 2025 Tags: * Admin GraphQL API * 2025-01 ### [Admin access input is now optional when setting metafield definition access](https://shopify.dev/changelog/admin-access-input-is-now-optional-when-setting-metafield-definition-access) When creating or updating a metafield definition's `access` the `admin` field is now optional. When `admin` is not explicitly set, it will default the same way it is when the entire `access` field... [Read full post –>](https://shopify.dev/changelog/admin-access-input-is-now-optional-when-setting-metafield-definition-access) * January 1, 2025 Tags: * Admin GraphQL API * 2025-01 ### [Change to FulfillmentOrderSortKeys](https://shopify.dev/changelog/change-to-fulfillmentordersortkeys) Starting in API version **2025-01**, RELEVANCE will be removed as a valid value from... [Read full post –>](https://shopify.dev/changelog/change-to-fulfillmentordersortkeys) * January 1, 2025 Tags: * Action Required * Admin GraphQL API * Admin REST API * Webhook * 2025-01 ### [Apply multiple holds to a single fulfillment order](https://shopify.dev/changelog/apply-multiple-holds-to-a-single-fulfillment-order) The 2025-01 API allows multiple holds per fulfillment order, requires unique handles, and introduces new webhooks. REST API remains limited to single holds. [Read full post –>](https://shopify.dev/changelog/apply-multiple-holds-to-a-single-fulfillment-order) * January 1, 2025 Tags: * Admin GraphQL API * 2025-01 ### [Enhanced variant query limits for single product queries](https://shopify.dev/changelog/enhanced-variant-query-limits-for-single-product-queries) As of the **2025-01** version of the GraphQL Admin API, you can now use a limit of up to 2000 variants when running a query on a single product, such as `product` or `productByHandle`. This... [Read full post –>](https://shopify.dev/changelog/enhanced-variant-query-limits-for-single-product-queries) * January 1, 2025 Tags: * Action Required * Admin GraphQL API * 2025-01 ### [New validation against duplicate handles in productCreate, productUpdate, and productSet mutation inputs](https://shopify.dev/changelog/new-validation-against-duplicate-handles-in-productcreate-productupdate-and-productset-mutation-inputs) In Admin GraphQL API `2025-01`, `handle` in product inputs must be unique, preventing duplicates in product creation/updates. Existing behavior unchanged if `handle` is omitted. [Read full post –>](https://shopify.dev/changelog/new-validation-against-duplicate-handles-in-productcreate-productupdate-and-productset-mutation-inputs) * January 1, 2025 Tags: * Admin GraphQL API * Webhook * 2025-01 ### [Introduce a `tax_exempt` field associated to a `CompanyLocation`](https://shopify.dev/changelog/introduce-a-tax_exempt-field-associated-to-a-companylocation) As of Admin API 2024-10, we have introduced a concept of `tax_exempt` in a `CompanyLocationTaxSettings` object for a `CompanyLocations`. This is a generic tax exemption flag for company locations outs [Read full post –>](https://shopify.dev/changelog/introduce-a-tax_exempt-field-associated-to-a-companylocation) * December 31, 2024 Tags: * Admin GraphQL API * 2025-01 ### [Events and Origins in Store Credit Account Transactions](https://shopify.dev/changelog/events-and-origins-in-store-credit-account-transactions) Admin API 2025-01 adds 'event' and 'origin' fields to store credit transactions, enhancing traceability and auditing for better financial reporting and customer service. [Read full post –>](https://shopify.dev/changelog/events-and-origins-in-store-credit-account-transactions) * December 18, 2024 Tags: * Admin GraphQL API * 2025-01 ### [Removal of deprecated shop fields](https://shopify.dev/changelog/removal-of-unused-deprecated-fields) Admin GraphQL API `2025-01` removes deprecated fields; use `QueryRoot` for collection, customer, draft order, marketing, order, and product queries. [Read full post –>](https://shopify.dev/changelog/removal-of-unused-deprecated-fields) * December 17, 2024 Tags: * Admin GraphQL API * 2025-01 ### [Improved `productTags`, `productVendors`, `productTypes`](https://shopify.dev/changelog/improved-producttags-productvendors-producttypes) Admin GraphQL API `2025-01` moves `productTags`, `productTypes`, `productVendors` to `QueryRoot`, now paginated and supporting over 250 results, enhancing data retrieval. [Read full post –>](https://shopify.dev/changelog/improved-producttags-productvendors-producttypes) * December 16, 2024 Tags: * Admin GraphQL API * 2025-01 ### [New inventoryPolicy argument for billing mutations](https://shopify.dev/changelog/inventorypolicy-argument-now-available-on-billing-attempts) New 'inventoryPolicy' argument lets developers override merchant inventory settings in billing mutations, offering flexibility in managing inventory during billing attempts. [Read full post –>](https://shopify.dev/changelog/inventorypolicy-argument-now-available-on-billing-attempts) * December 16, 2024 Tags: * Admin GraphQL API * 2025-01 ### [New `LocalizationExtensionKeys` value for Mexico](https://shopify.dev/changelog/new-localizationextensionkeys-value-for-mexico) As of version `2025-01` of the Admin GraphQL API, we're adding a new LocalizationExtensionsKey value to support the collection shipping credentials for cross-border shipments into Mexico:... [Read full post –>](https://shopify.dev/changelog/new-localizationextensionkeys-value-for-mexico) * December 16, 2024 Tags: * Admin GraphQL API * 2025-01 ### [New revocation reasons for payment methods for 2025-01](https://shopify.dev/changelog/new-revocation-reasons-for-payment-methods-for-2025-01) As of GraphQL Admin API version 2025-01, we've added new values to the `CustomerPaymentMethodRevocationReason` enum to provide more granular information about payment method revocations. This... [Read full post –>](https://shopify.dev/changelog/new-revocation-reasons-for-payment-methods-for-2025-01) * December 16, 2024 Tags: * Admin GraphQL API * 2025-01 ### [Search discountNodes by exact discount code in the GraphQL Admin API](https://shopify.dev/changelog/search-discountnodes-by-exact-discount-code-in-the-graphql-admin-api) As of API `2025-01`, you can use discountsNodes() to search for exact discount codes with the `code` prefix in the query argument. [Read full post –>](https://shopify.dev/changelog/search-discountnodes-by-exact-discount-code-in-the-graphql-admin-api) * December 13, 2024 Tags: * Action Required * Admin GraphQL API * 2025-01 ### [Changes to ScriptTag displayScope field on Admin GraphQL API](https://shopify.dev/changelog/changes-to-scripttag-displayscope-field-on-admin-graphql-api) Using Script Tags? Start ensuring you're targeting the ONLINE\_STORE as the `displayScope`. [Read full post –>](https://shopify.dev/changelog/changes-to-scripttag-displayscope-field-on-admin-graphql-api) * December 11, 2024 Tags: * Admin GraphQL API * 2025-01 ### [Improved billing attempt error handling for subscriptions in Selling Plan API](https://shopify.dev/changelog/improved-billing-attempt-error-handling-for-subscriptions-in-selling-plan-api) Subscription billing now respects inventory policies, preventing overselling. New processingError feature helps identify product variants causing billing errors, enhancing error diagnostics. [Read full post –>](https://shopify.dev/changelog/improved-billing-attempt-error-handling-for-subscriptions-in-selling-plan-api) * December 11, 2024 Tags: * Admin GraphQL API * 2025-01 ### [Using custom ids and handles in product and customer lookups](https://shopify.dev/changelog/using-custom-ids-and-handles-in-product-and-customer-lookups) As of `2025-01` Admin API, you can use your own identifiers to lookup Products and Customers with the following APIs: * `customerByIdentifier` * `productByIdentifier` Custom ids are defined... [Read full post –>](https://shopify.dev/changelog/using-custom-ids-and-handles-in-product-and-customer-lookups) * December 11, 2024 Tags: * Admin GraphQL API * 2025-01 ### [Adding unique values to metafields](https://shopify.dev/changelog/adding-unique-values-to-metafields) As of `2025-01` Admin API, you can now make metafield definitions that enforce uniqueness. The new `uniqueValues` capability ensures that each metafield has a unique value across all resources.... [Read full post –>](https://shopify.dev/changelog/adding-unique-values-to-metafields) * December 11, 2024 Tags: * Admin GraphQL API * 2025-01 ### [Set custom prices in draft orders](https://shopify.dev/changelog/set-custom-prices-in-draft-orders) Draft orders now auto-update to current prices at checkout. Set custom prices on line items via GraphQL API, locking them for all calculations like taxes and discounts. [Read full post –>](https://shopify.dev/changelog/set-custom-prices-in-draft-orders) * December 10, 2024 Tags: * Action Required * Admin GraphQL API * Liquid * 2025-01 ### [Simplifying how metafield and metaobject permissions work](https://shopify.dev/changelog/simplifying-how-metafield-and-metaobject-permissions-work) In the new year we’re simplifying how metafield and metaobject permissions work. This makes the system easier to work with and will further improve API response times. In summary: * On \*\*Jan... [Read full post –>](https://shopify.dev/changelog/simplifying-how-metafield-and-metaobject-permissions-work) * December 6, 2024 Tags: * Admin GraphQL API * 2025-01 ### [Customize line items in Checkout and Customer Accounts order summary using new Checkout Branding API settings](https://shopify.dev/changelog/customize-line-items-in-checkout-and-customer-accounts-order-summary-using-new-checkout-branding-api-settings) As of Dec 4, 2024, Shopify Plus merchants can customize product thumbnails and quantity badge colors in Checkout via the Checkout Branding API. Aspect ratio setting is in unstable release. [Read full post –>](https://shopify.dev/changelog/customize-line-items-in-checkout-and-customer-accounts-order-summary-using-new-checkout-branding-api-settings) * December 5, 2024 Tags: * Action Required * Admin GraphQL API * Webhook * 2025-01 ### [PrivateMetafield is now deprecated](https://shopify.dev/changelog/privatemetafield-is-now-deprecated) Starting in API version **2025-01**, PrivateMetafield will be removed from the GraphQL Admin API. Use \](https://shopify.dev/changelog/privatemetafield-is-now-deprecated) * November 15, 2024 Tags: * Admin GraphQL API * Admin REST API * 2025-01 ### [`manualPaymentGateway` field added to `orderTransaction` object](https://shopify.dev/changelog/manualpaymentgateway-field-added-to-ordertransaction-object) As of GraphQL Admin API version 2025-01, the `manualPaymentGateway` field will be added to `orderTransaction` object. This field indicates if the transaction is processed by a manual payment... [Read full post –>](https://shopify.dev/changelog/manualpaymentgateway-field-added-to-ordertransaction-object) * November 5, 2024 Tags: * Action Required * Admin GraphQL API * 2025-01 ### [Remove `metafieldDelete` in favor of `metafieldsDelete`](https://shopify.dev/changelog/remove-metafielddelete-in-favor-of-metafieldsdelete) As of `2025-01` the `metafieldDelete` Admin API method is being removed. The `metafieldsDelete` method should be used instead. The former relies on the Metafield GID, while the latter takes an... [Read full post –>](https://shopify.dev/changelog/remove-metafielddelete-in-favor-of-metafieldsdelete) * November 1, 2024 Tags: * Admin GraphQL API * Customer Account API * Payments Apps API * 2025-01 ### [GraphQL Over HTTP](https://shopify.dev/changelog/graphql-over-http) GraphQL requests now support `application/graphql-response+json` format, affecting status codes. Use `/graphql` endpoint, `application/json` content type, and updated `Accept` headers for `2025-01` API. [Read full post –>](https://shopify.dev/changelog/graphql-over-http) * November 1, 2024 Tags: * Action Required * Admin GraphQL API * Customer Account API * Payments Apps API * 2025-01 ### [Content type `application/graphql` is deprecated](https://shopify.dev/changelog/content-type-application-graphql-is-deprecated) The `Content-Type: application/graphql` request format is deprecated and will no longer be accepted as of 2025-01 schema versions. As of `2025-01` schemas, all requests must specify \`Content-Type:... [Read full post –>](https://shopify.dev/changelog/content-type-application-graphql-is-deprecated) * November 1, 2024 Tags: * Action Required * Admin GraphQL API * 2025-01 ### [Removing `multiLocation` field from `ShopFeatures`](https://shopify.dev/changelog/removing-multilocation-field-from-shopfeatures) As of the **2025-01** release of the Admin GraphQL API, the deprecated `multiLocation` field on [ShopFeatures](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopFeatures) will be... [Read full post –>](https://shopify.dev/changelog/removing-multilocation-field-from-shopfeatures)