--- 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?action_required=true md: https://shopify.dev/changelog.md?action_required=true --- # 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) * December 22, 2025 Tags: * Action Required * Admin GraphQL API * 2026-01 ### [Deprecation of `Shop.billingAddress` in favor of `Shop.shopAddress`](https://shopify.dev/changelog/deprecation-of-shop-billingaddress-in-favor-of-shop-shopaddress) API version 2026-01 introduces `shopAddress` in `Shop` object, replacing `billingAddress`. Update queries to use `shopAddress` for future compatibility. Structure remains unchanged. [Read full post –>](https://shopify.dev/changelog/deprecation-of-shop-billingaddress-in-favor-of-shop-shopaddress) * December 19, 2025 Tags: * Action Required * Admin GraphQL API * Admin REST API * 2026-04 ### [Removing `permitsSkuSharing` field from fulfillment service](https://shopify.dev/changelog/removing-permitsskusharing-field-from-fulfillment-service) In API version 2026-04, `permitsSkuSharing` is removed from `FulfillmentService`. Permits SKU sharing will be enabled by default. [Read full post –>](https://shopify.dev/changelog/removing-permitsskusharing-field-from-fulfillment-service) * December 18, 2025 Tags: * Action Required * Admin GraphQL API ### [Customer marketing URL fields now require write access](https://shopify.dev/changelog/customer-marketing-url-fields-now-require-write-access) Customer-related fields now require `write_customers` scope and `create_and_edit_customers` permission due to security fixes. Update apps to avoid access denied errors. [Read full post –>](https://shopify.dev/changelog/customer-marketing-url-fields-now-require-write-access) * December 15, 2025 Tags: * Action Required * Functions * 2026-01 ### [Venmo and PayPal are now treated as separate payment methods](https://shopify.dev/changelog/venmo-and-paypal-are-now-treated-as-separate-payment-methods) In API version 2026-01, Venmo and PayPal are separate in payment customization. Update logic to hide Venmo independently from PayPal for desired behavior. [Read full post –>](https://shopify.dev/changelog/venmo-and-paypal-are-now-treated-as-separate-payment-methods) * December 12, 2025 Tags: * Action Required * Admin GraphQL API * 2026-04 ### [New compare and swap syntax for the `inventorySetQuantities` mutation](https://shopify.dev/changelog/finalizing-compare-and-swap-redesign-for-inventory-set-quantities) The `changeFromQuantity` field is now mandatory; use `null` to bypass checks. `compareQuantity` and `ignoreCompareQuantity` fields are removed, impacting inventory mutation handling. [Read full post –>](https://shopify.dev/changelog/finalizing-compare-and-swap-redesign-for-inventory-set-quantities) * December 12, 2025 Tags: * Action Required * Admin GraphQL API * 2026-01 ### [Concurrency protection features for inventory and refund mutations](https://shopify.dev/changelog/concurrency-protection-features) New concurrency protection features: `changeFromQuantity` field and `idempotent` directive will be required for inventory and refund mutations. Breaking changes. [Read full post –>](https://shopify.dev/changelog/concurrency-protection-features) * December 12, 2025 Tags: * Action Required * Admin GraphQL API * 2026-04 ### [Making `changeFromQuantity` field required (with explicit opt-out)](https://shopify.dev/changelog/making-changefromquantity-field-required) Starting April 2026, `changeFromQuantity` is required for inventory mutations. This ensures data accuracy by preventing overwrites if quantities change concurrently. Use `null` to opt-out. [Read full post –>](https://shopify.dev/changelog/making-changefromquantity-field-required) * December 12, 2025 Tags: * Action Required * Admin GraphQL API * 2026-04 ### [Making idempotency mandatory for inventory adjustments and refund mutations](https://shopify.dev/changelog/making-idempotency-mandatory-for-inventory-adjustments-and-refund-mutations) Starting April 2026, idempotency is mandatory for specific Shopify mutations to prevent duplicate inventory adjustments and refunds, enhancing integration robustness and reducing errors. [Read full post –>](https://shopify.dev/changelog/making-idempotency-mandatory-for-inventory-adjustments-and-refund-mutations) * November 20, 2025 Tags: * Action Required * Webhook * Admin GraphQL API * 2026-01 ### [Tax summary webhook `created_at` field now returns UTC timezone](https://shopify.dev/changelog/tax-summary-webhook-created-at-field-now-returns-utc-timezone) The `created_at` field now returns UTC format, improving consistency across systems. Developers should update parsing logic to handle the new format starting January 2026. [Read full post –>](https://shopify.dev/changelog/tax-summary-webhook-created-at-field-now-returns-utc-timezone) * November 12, 2025 Tags: * Action Required * Admin GraphQL API * Webhook * 2026-01 ### [Tax webhook summary and calculation requests now use Global IDs](https://shopify.dev/changelog/tax-webhook-summary-and-calculation-requests-now-use-global-ids) Third-party tax apps now receive Global IDs for entity identification, aligning with Shopify's GraphQL Admin API standards. [Read full post –>](https://shopify.dev/changelog/tax-webhook-summary-and-calculation-requests-now-use-global-ids) * November 10, 2025 Tags: * Action Required * Platform ### [Protected customer data scopes required for web pixel PII access starting on December 10th](https://shopify.dev/changelog/protected-customer-data-scopes-required) Starting Dec 10, 2025, Shopify will enforce protected customer data policies for web pixels. Apps need approved scopes to access PII; otherwise, fields will be null. Update and test your app. [Read full post –>](https://shopify.dev/changelog/protected-customer-data-scopes-required) * October 30, 2025 Tags: * Action Required * Storefront GraphQL API * 2026-01 ### [The `cartDiscountCodeUpdate` mutation now requires the `discountCodes` field](https://shopify.dev/changelog/the-cartdiscountcodeupdate-mutation-now-requires-the-discountcodes-field) In the GraphQL Storefront API 2026-01 release, `cartDiscountCodesUpdate` now requires the `discountCodes` argument. [Read full post –>](https://shopify.dev/changelog/the-cartdiscountcodeupdate-mutation-now-requires-the-discountcodes-field) * October 29, 2025 Tags: * Action Required * Admin GraphQL API * 2026-01 ### [Bulk operations group objects default changed to `false`](https://shopify.dev/changelog/bulk-operations-group-objects-default-changed-to-false) GraphQL Admin API bulk operations are now faster and more reliable. `groupObjects` defaults to `false` for queries and is deprecated for mutations. Adjust settings for grouped output if needed. [Read full post –>](https://shopify.dev/changelog/bulk-operations-group-objects-default-changed-to-false) * October 10, 2025 Tags: * Action Required * Admin GraphQL API * 2026-01 ### [Removing `visible_to_storefront_api` field on metaobject field definitions](https://shopify.dev/changelog/removing-storefront-visibility-field-on-metaobject-field-definitions) The `visible_to_storefront_api` field is deprecated and removed. Use the `access` input field to configure storefront accessibility of metaobjects. [Read full post –>](https://shopify.dev/changelog/removing-storefront-visibility-field-on-metaobject-field-definitions) * September 30, 2025 Tags: * Action Required * Admin GraphQL API ### [Upcoming Markets pricing support for Draft Order checkouts](https://shopify.dev/changelog/upcoming-markets-pricing-support-for-draft-order-checkouts) From October 31 2025, updating a shipping address in Draft Order checkout may alter prices based on Markets settings. Use `priceOverride` or `generatePriceOverride` to maintain prices. [Read full post –>](https://shopify.dev/changelog/upcoming-markets-pricing-support-for-draft-order-checkouts) * September 26, 2025 Tags: * Action Required * Admin GraphQL API * 2026-01 ### [Removal of deprecated `Shop.draftOrders` connection in the GraphQL Admin API](https://shopify.dev/changelog/removal-of-deprecated-shopdraftorders-connection-in-admin-graphql-api) The `Shop.draftOrders` connection is removed in GraphQL Admin API v2026-01. Use `QueryRoot.draftOrders` to access multiple draft orders. [Read full post –>](https://shopify.dev/changelog/removal-of-deprecated-shopdraftorders-connection-in-admin-graphql-api) * September 20, 2025 Tags: * Action Required * Tools * Admin REST API * Checkout UI * Functions * Storefront GraphQL API ### [Your app may be affected by remote products](https://shopify.dev/changelog/your-app-may-be-affected-by-remote-products) Remote products can now be displayed on storefronts. Update Cart Ajax API logic to exclude remote items for shipping, discounts, and recovery. Remote items aren't supported in Shopify Functions. [Read full post –>](https://shopify.dev/changelog/your-app-may-be-affected-by-remote-products) * September 9, 2025 Tags: * Action Required * Tools ### [Upgrade to the latest version of Checkout Kit to avoid issues with iOS 26](https://shopify.dev/changelog/upgrade-to-the-latest-version-of-checkout-kit-to-avoid-issues-with-ios-26) Update your app to the latest Checkout Kit (Swift 3.3.1, Kotlin 3.5.1, React-native 3.3.1) to ensure compatibility with iOS 26 and prevent checkout issues. [Read full post –>](https://shopify.dev/changelog/upgrade-to-the-latest-version-of-checkout-kit-to-avoid-issues-with-ios-26) * 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 3, 2025 Tags: * Action Required * Tools ### [Next-Gen developer platform now available to all app developers](https://shopify.dev/changelog/next-gen-dev-platform-ga) Create dev stores on any plan, use app dev preview for instant iteration, manage metaobjects in code, and utilize the new Dev Dashboard for streamlined app management and migration. [Read full post –>](https://shopify.dev/changelog/next-gen-dev-platform-ga) * 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) * 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 12, 2025 Tags: * Action Required * Webhook * 2026-01 ### [Deprecation of the checkout\_and\_accounts\_configurations/update webhook](https://shopify.dev/changelog/deprecation-of-checkoutandaccountsconfigurationsupdate-webhook) The `checkout_and_accounts_configurations/update` webhook will be deprecated on Jan 1, 2026. Use the Admin API `checkoutProfiles` query for tracking updates instead. [Read full post –>](https://shopify.dev/changelog/deprecation-of-checkoutandaccountsconfigurationsupdate-webhook) * 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 4, 2025 Tags: * Action Required * API ### [\_shopify\_y and \_shopify\_s cookies will no longer be set](https://shopify.dev/changelog/shopifyy-and-shopifys-cookies-will-no-longer-be-set) Starting Jan 1, 2026, Shopify stops setting `_shopify_s` and `_shopify_y` cookies. Use Web Pixels API for `_shopify_y` and create session-length cookies for `_shopify_s` replacement. [Read full post –>](https://shopify.dev/changelog/shopifyy-and-shopifys-cookies-will-no-longer-be-set) * August 4, 2025 Tags: * Action Required * API ### [\_tracking\_consent, \_landing\_page, \_orig\_referrer cookies will no longer be set](https://shopify.dev/changelog/trackingconsent-landingpage-origreferrer-cookies-will-no-longer-be-set) Starting Sept 15, 2025, Shopify stops setting `_landing_page`, `_orig_referrer`, `_tracking_consent` cookies. Update code to use browser APIs or Shopify APIs for these values. [Read full post –>](https://shopify.dev/changelog/trackingconsent-landingpage-origreferrer-cookies-will-no-longer-be-set) * 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 3, 2025 Tags: * Action Required * POS Extensions ### [POS UI Extensions 2025-07 update](https://shopify.dev/changelog/pos-ui-extensions-2025-07-update) POS UI Extensions update: Fixed component rendering, removed `FormattedTextField`, added properties to interfaces, deprecated `Icon` props, and introduced Storage API for data storage. [Read full post –>](https://shopify.dev/changelog/pos-ui-extensions-2025-07-update) * July 2, 2025 Tags: * Action Required * API ### [Changes to Cart token format for AJAX and Storefront GraphQL Cart APIs](https://shopify.dev/changelog/changes-to-cart-token-format-for-ajax-and-storefront-graphql-cart-apis) Cart tokens have changed format [Read full post –>](https://shopify.dev/changelog/changes-to-cart-token-format-for-ajax-and-storefront-graphql-cart-apis) * July 1, 2025 Tags: * Action Required * Built for Shopify ### [New Built for Shopify requirements for marketing apps – Effective July 1, 2025](https://shopify.dev/changelog/new-built-for-shopify-requirements-for-marketing-apps-effective-july-1-2025) Starting July 1, 2025, new category-specific requirements for marketing apps in the Built for Shopify program will be enforced during initial and annual reviews. [Read full post –>](https://shopify.dev/changelog/new-built-for-shopify-requirements-for-marketing-apps-effective-july-1-2025) * July 1, 2025 Tags: * Action Required * Admin GraphQL API * 2025-07 ### [New field for discount classes on `DraftOrderPlatformDiscount`](https://shopify.dev/changelog/new-field-for-discount-classes-on-draftorderplatformdiscount) The `discountClass` field is deprecated; use `discountClasses` for multiple discount classes. Continue using `presentationLevel` to see `DraftOrderPlatformDiscount` effects. [Read full post –>](https://shopify.dev/changelog/new-field-for-discount-classes-on-draftorderplatformdiscount) * 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 28, 2025 Tags: * Action Required * Admin GraphQL API * Admin REST API * Customer Account API * Payments Apps API * Storefront GraphQL API * Webhook ### [Deprecation of POST requests without a Content-Length or Transfer-Encoding: chunked header](https://shopify.dev/changelog/deprecation-of-post-requests-without-a-content-length-or-transfer-encoding-chunked-header) Update client libraries to include Content-Length or Transfer-Encoding: chunked in POST requests by August 1, 2025, to avoid HTTP 411 errors. [Read full post –>](https://shopify.dev/changelog/deprecation-of-post-requests-without-a-content-length-or-transfer-encoding-chunked-header) * June 27, 2025 Tags: * Action Required * API ### [Buy Button JS must be upgraded to the latest version](https://shopify.dev/changelog/buy-button-js-must-be-upgraded-to-the-latest-version) Update Buy Button JS by August 1, 2025, to maintain functionality. Ensure your Buy Button JS code is updated with the latest version. [Read full post –>](https://shopify.dev/changelog/buy-button-js-must-be-upgraded-to-the-latest-version) * May 21, 2025 Tags: * Action Required * Admin GraphQL API * 2025-07 ### [Deprecation of legacy return APIs and improvements to return management](https://shopify.dev/changelog/deprecation-of-legacy-return-apis-and-improvements-to-return-management) Shopify Admin API updates: returnRefund deprecated, replaced by returnProcess for streamlined return management. Available now in unstable, official release in 2025-07. [Read full post –>](https://shopify.dev/changelog/deprecation-of-legacy-return-apis-and-improvements-to-return-management) * May 21, 2025 Tags: * Action Required * Admin GraphQL API ### [Deprecation of Product, Order, and Shipping Discount Function APIs](https://shopify.dev/changelog/deprecation-product-order-shipping-discount-function-apis) Product, Order, and Shipping Discount Function APIs are replaced by the new Discount Function API. Transition by API version 2026-04 in order to benefit from the new simplified and flexible API. [Read full post –>](https://shopify.dev/changelog/deprecation-product-order-shipping-discount-function-apis) * May 21, 2025 Tags: * Action Required * Admin GraphQL API * 2025-07 ### [Uncapped counts in GraphQL](https://shopify.dev/changelog/uncapped-graphql-counts) GraphQL count APIs now return uncapped results with `limit=null`. All APIs standardized; `limit` defaults to `10000`, introducing a breaking change. [Read full post –>](https://shopify.dev/changelog/uncapped-graphql-counts) * May 19, 2025 Tags: * Action Required * Admin GraphQL API ### [Public access for app owned metafields and metaobjects is now disabled](https://shopify.dev/changelog/public-access-for-app-owned-metafields-and-metaobjects-is-now-disabled) Metafields access is changing: `PUBLIC` access is removed, now set to `MERCHANT_READ_WRITE`. Migrate to a custom namespace if other apps need read access. [Read full post –>](https://shopify.dev/changelog/public-access-for-app-owned-metafields-and-metaobjects-is-now-disabled) * May 15, 2025 Tags: * Action Required * Shopify Theme Store ### [Updated Shopify Theme Store Requirements and Submission Process – Effective May 15, 2025](https://shopify.dev/changelog/updated-shopify-theme-store-requirements-and-submission-process-effective-may-15-2025) Shopify themes must meet new requirements for submitting and updating theme listings, starting May 15, 2025. [Read full post –>](https://shopify.dev/changelog/updated-shopify-theme-store-requirements-and-submission-process-effective-may-15-2025) * May 6, 2025 Tags: * Action Required * Admin GraphQL API * Functions * Storefront GraphQL API ### [Deprecating `gates` types and fields across the GraphQL Admin, Storefront, and Functions APIs](https://shopify.dev/changelog/gates-api-sunset) Shopify is retiring `gates` types and fields in favour of metafields and metaobjects for better custom data management across Admin, Storefront, and Functions APIs. [Read full post –>](https://shopify.dev/changelog/gates-api-sunset) * April 30, 2025 Tags: * Action Required * API ### [Web Pixels API: `event.data.checkout.subtotalPrice.amount` value change on the new `/thank-you` page and checkout events](https://shopify.dev/changelog/web-pixels-api-eventdatacheckoutsubtotalpriceamount-value-change-on-the-new-thank-you-page-and-checkout-events) `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. [Read full post –>](https://shopify.dev/changelog/web-pixels-api-eventdatacheckoutsubtotalpriceamount-value-change-on-the-new-thank-you-page-and-checkout-events) * April 22, 2025 Tags: * Action Required * Admin GraphQL API ### [New arguments added to `statusPageUrl` field on the `Order` object](https://shopify.dev/changelog/new-arguments-added-to-statuspageurl-field-on-order-object) Order status URLs now use capability tokens instead of static keys, improving security with limited uses and automatic expiration. Optional parameters available for customization. [Read full post –>](https://shopify.dev/changelog/new-arguments-added-to-statuspageurl-field-on-order-object) * April 22, 2025 Tags: * Action Required * POS Extensions ### [POS UI Extensions - Cart API: Customer fields removed from `subscribable` hook](https://shopify.dev/changelog/pos-ui-extensions-cart-api-customer-fields-removed-from-subscribable-hook) 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`. [Read full post –>](https://shopify.dev/changelog/pos-ui-extensions-cart-api-customer-fields-removed-from-subscribable-hook) * April 17, 2025 Tags: * Action Required * Admin GraphQL API * 2025-07 ### [Change in `productSet` mutation error code for suspended product](https://shopify.dev/changelog/change-in-productset-mutation-error-code-for-suspended-product) `productSet` mutation returns more precise `PRODUCT_SUSPENDED` error code [Read full post –>](https://shopify.dev/changelog/change-in-productset-mutation-error-code-for-suspended-product) * April 16, 2025 Tags: * Action Required * Shopify App Store ### [Payment apps can no longer be embedded in the Shopify admin](https://shopify.dev/changelog/payment-apps-can-no-longer-be-embedded-in-the-shopify-admin) Starting April 29, 2025, payment apps can no longer be embedded in the Shopify admin. [Read full post –>](https://shopify.dev/changelog/payment-apps-can-no-longer-be-embedded-in-the-shopify-admin) * March 17, 2025 Tags: * Action Required * Admin GraphQL API * 2025-04 ### [Deprecating PriceListUserErrorCode values](https://shopify.dev/changelog/deprecating-pricelistusererrorcode-values) Starting from 2025-04, unused `PriceListErrorCode` values will be removed. [Read full post –>](https://shopify.dev/changelog/deprecating-pricelistusererrorcode-values) * March 13, 2025 Tags: * Action Required * API ### [Now available: JS Buy SDK v3.0](https://shopify.dev/changelog/now-available-js-buy-sdk-v30) JS Buy SDK v3.0 is now available [Read full post –>](https://shopify.dev/changelog/now-available-js-buy-sdk-v30) * March 7, 2025 Tags: * Action Required * POS Extensions * 2025-04 ### [End of Compatibility for Old POS UI Extensions Versions](https://shopify.dev/changelog/end-of-compatibility-for-old-pos-ui-extensions-versions) 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. [Read full post –>](https://shopify.dev/changelog/end-of-compatibility-for-old-pos-ui-extensions-versions) * March 2, 2025 Tags: * Action Required * Admin REST API * Storefront GraphQL API * 2025-04 ### [Checkout APIs will be shut down April 1, 2025](https://shopify.dev/changelog/checkout-apis-will-be-shut-down-april-1-2025) All impacted apps need to update to the Storefront Cart API before April 1, 2025 to avoid disruptions. [Read full post –>](https://shopify.dev/changelog/checkout-apis-will-be-shut-down-april-1-2025) * February 27, 2025 Tags: * Action Required * Admin GraphQL API * 2025-07 ### [Metafield description input field removal](https://shopify.dev/changelog/metafield-description-field-removal) The `description` field for metafields is being removed in `unstable`. [Read full post –>](https://shopify.dev/changelog/metafield-description-field-removal) [Next](https://shopify.dev/changelog?action_required=true\&page=2)