--- 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 md: https://shopify.dev/changelog.md --- # 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 17, 2026 Tags: * Action Required * Shop Minis ### [Shop Minis development now requires Partner account permissions](https://shopify.dev/changelog/shop-minis-development-now-requires-partner-account-permissions) Shop Minis CLI now requires "Manage apps" permission in Partner accounts for setup and submissions. Developers must request access from admins to avoid errors. [Read full post –>](https://shopify.dev/changelog/shop-minis-development-now-requires-partner-account-permissions) * January 17, 2026 Tags: * API ### [Deprecating shopify\_y and shopify\_s cookies for Hydrogen](https://shopify.dev/changelog/tracking-cookie-deprecation-hydrogen) We’re replacing two legacy tracking cookies. Most Hydrogen stores only need a version upgrade. Do this by April 30, 2026, to ensure reliable analytics attribution. [Read full post –>](https://shopify.dev/changelog/tracking-cookie-deprecation-hydrogen) * January 17, 2026 Tags: * Admin GraphQL API * Admin REST API * 2026-04 ### [`inventoryActivate` now preserves `available` quantity](https://shopify.dev/changelog/inventoryactivate-now-preserves-available-quantity) In API 2026-04, `inventoryActivate` now preserves existing `active` and `onHand` quantities if `available` or `onHand` aren't provided, preventing unwanted resets to zero. [Read full post –>](https://shopify.dev/changelog/inventoryactivate-now-preserves-available-quantity) * January 15, 2026 Tags: * Admin GraphQL API * Webhook * 2026-04 ### [Tax summary webhook and calculation requests now include customer and company metafields](https://shopify.dev/changelog/tax-summary-webhook-and-calculation-requests-now-include-customer-and-company-metafields) API version 2026-01 adds buyer metafields to tax requests, enabling tax partners to use custom customer and company data for precise tax calculations and compliance in D2C and B2B orders. [Read full post –>](https://shopify.dev/changelog/tax-summary-webhook-and-calculation-requests-now-include-customer-and-company-metafields) * January 13, 2026 Tags: * Themes ### [Stricter Liquid parsing for themes and theme app extensions](https://shopify.dev/changelog/liquid-is-getting-faster-and-ready-to-evolve) Shopify is enforcing stricter Liquid parsing for all themes to improve reliability and enable future Liquid improvements. [Read full post –>](https://shopify.dev/changelog/liquid-is-getting-faster-and-ready-to-evolve) * January 12, 2026 Tags: * Action Required * API ### [Standardization of Asset URL Version Parameters](https://shopify.dev/changelog/standardization-of-asset-url-version-parameters) Asset URLs now use `?v=VERSION_STRING` for versioning. Update code parsing URLs to support this format, replacing assumptions about numeric-only query strings. [Read full post –>](https://shopify.dev/changelog/standardization-of-asset-url-version-parameters) * January 8, 2026 Tags: * Admin GraphQL API * 2026-04 ### [Deprecated `deliveryShippingOriginAssign` mutation](https://shopify.dev/changelog/deprecate-deliveryshippingoriginassign-mutation) The deliveryShippingOriginAssign mutation is being deprecated. [Read full post –>](https://shopify.dev/changelog/deprecate-deliveryshippingoriginassign-mutation) * January 1, 2026 Tags: * Admin GraphQL API * 2026-01 ### [`INVALID_BILLING_ADDRESS`: new processing error for subscription billing attempts](https://shopify.dev/changelog/subscription-billing-attempt-invalid-billing-address-error) New error INVALID\_BILLING\_ADDRESS for subscription billing attempts flags invalid billing address fields. [Read full post –>](https://shopify.dev/changelog/subscription-billing-attempt-invalid-billing-address-error) * January 1, 2026 Tags: * Admin GraphQL API * Customer Account API * Webhook * 2026-01 ### [New Return Reason Definitions API for Better Return Insights](https://shopify.dev/changelog/new-return-reason-definitions-api-for-better-return-insights) A new `ReturnReasonDefinition` type replaces `ReturnReason`, providing category-specific return reasons for better analytics and improved return experiences. [Read full post –>](https://shopify.dev/changelog/new-return-reason-definitions-api-for-better-return-insights) * January 1, 2026 Tags: * Admin GraphQL API * 2026-01 ### [Subscription billing attempts throttling](https://shopify.dev/changelog/subscription-billing-attempts-throttling) We're introducing throttling for billing attempts, with errors visible in the `throttled` code on the `BillingAttemptUserErrorCode` code. [Read full post –>](https://shopify.dev/changelog/subscription-billing-attempts-throttling) * January 1, 2026 Tags: * Admin GraphQL API * 2026-01 ### [Access transactions on the Return object](https://shopify.dev/changelog/access-transactions-on-the-return-object) The Admin GraphQL API now includes a `transactions` connection in the `Return` object, simplifying payment/refund associations for returns, enhancing financial reporting accuracy. [Read full post –>](https://shopify.dev/changelog/access-transactions-on-the-return-object) * January 1, 2026 Tags: * Admin GraphQL API * Webhook * 2026-01 ### [Introducing the `orders/link_requested` webhook topic](https://shopify.dev/changelog/introducing-the-orderslinkrequested-webhook-topic) API v2026-01 adds an `orders/link_requested` webhook, notifying subscribed apps when customers request new order links from expired **Order status** pages. [Read full post –>](https://shopify.dev/changelog/introducing-the-orderslinkrequested-webhook-topic) * 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: * Admin GraphQL API * 2026-01 ### [Conversion tracking fields added to MarketingEngagementCreate](https://shopify.dev/changelog/conversion-tracking-fields-added-to-marketing-engagement-create) New fields in `MarketingEngagementCreate` enhance data integration for marketing metrics, supporting diverse conversion tracking and analytics in Shopify's reports. [Read full post –>](https://shopify.dev/changelog/conversion-tracking-fields-added-to-marketing-engagement-create) * 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 17, 2025 Tags: * Functions * 2026-01 ### [Discount Function support for rejecting discount codes](https://shopify.dev/changelog/discount-rejection-support-for-discount-functions) The Discount Function API now lets merchants reject discounts with custom messages, preventing double discounts, managing code combinations, and disqualifying products. [Read full post –>](https://shopify.dev/changelog/discount-rejection-support-for-discount-functions) * December 16, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Set and retrieve `processedAt` in the `refundCreate` mutation](https://shopify.dev/changelog/set-processed-at-in-refund-create) The `refundCreate` mutation now supports an optional `processedAt` field. [Read full post –>](https://shopify.dev/changelog/set-processed-at-in-refund-create) * 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 15, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Faster bulk operations](https://shopify.dev/changelog/faster-bulk-operations) Shopify's bulk operations API now supports all Admin API mutations, allows 100MB file uploads, and enables five concurrent operations, enhancing speed and efficiency for developers. [Read full post –>](https://shopify.dev/changelog/faster-bulk-operations) * December 12, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Improved compare and swap inventory updates for the `inventorySetQuantities` mutation](https://shopify.dev/changelog/compare-and-swap-redesign-for-inventory-set-quantities) `inventorySetQuantities` now supports a cleaner way to handle concurrent updates. Use the new `changeFromQuantity` field instead of the deprecated `compareQuantity` and `ignoreCompareQuantity` fields. [Read full post –>](https://shopify.dev/changelog/compare-and-swap-redesign-for-inventory-set-quantities) * December 12, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Adding idempotency for inventory adjustments and refund mutations](https://shopify.dev/changelog/adding-idempotency-for-inventory-adjustments-and-refund-mutations) Idempotency keys are now available on refund and inventory mutations starting in API version 2026-01, enabling safer request retries and preventing duplicate operations. [Read full post –>](https://shopify.dev/changelog/adding-idempotency-for-inventory-adjustments-and-refund-mutations) * December 12, 2025 Tags: * Admin GraphQL API * 2026-01 ### [New `changeFromQuantity` field to manage inventory](https://shopify.dev/changelog/compare-and-swap-for-inventory-mutations-with-change-from-quantity) The `changeFromQuantity` field ensures inventory data stays accurate, even if you're making multiple adjustments at the same time. [Read full post –>](https://shopify.dev/changelog/compare-and-swap-for-inventory-mutations-with-change-from-quantity) * December 12, 2025 Tags: * Admin GraphQL API ### [Deprecation of `OrderTransaction.authorizationCode` in favor of `OrderTransaction.paymentId`](https://shopify.dev/changelog/deprecation-of-ordertransaction-authorizationcode-in-favor-of-ordertransactionpaymentid) From API version `2026-01`, `authorizationCode` in `OrderTransaction` is deprecated. Use `paymentId` for stable payment tracking. Update queries to replace `authorizationCode` with `paymentId`. [Read full post –>](https://shopify.dev/changelog/deprecation-of-ordertransaction-authorizationcode-in-favor-of-ordertransactionpaymentid) * December 12, 2025 Tags: * API ### [Removal of payment method requirement on API created Subscription contracts](https://shopify.dev/changelog/removal-of-payment-method-requirement-on-api-created-subscription-contracts) You can now create subscription contracts without a payment method via GraphQL Admin API, simply migrate them to Shopify first and collect or update payment details later. [Read full post –>](https://shopify.dev/changelog/removal-of-payment-method-requirement-on-api-created-subscription-contracts) * 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) * 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 10, 2025 Tags: * Platform ### [The Winter '26 Edition is here](https://shopify.dev/changelog/the-winter-26-edition-is-here) 150+ updates for the commerce renaissance. [Read full post –>](https://shopify.dev/changelog/the-winter-26-edition-is-here) * December 10, 2025 Tags: * Tools * Functions ### [Binary testing for Shopify Functions](https://shopify.dev/changelog/binary-testing-for-shopify-functions) Build tests from real production data and catch breaking changes before they hit production with comprehensive binary testing for Shopify Functions. [Read full post –>](https://shopify.dev/changelog/binary-testing-for-shopify-functions) * December 10, 2025 Tags: * Tools ### [Multi-environment theme commands in Shopify CLI](https://shopify.dev/changelog/multi-environment-theme-commands-shopify-cli) Run theme commands across multiple stores at once. Push, pull, or publish to dev, staging, and production environments in a single operation. [Read full post –>](https://shopify.dev/changelog/multi-environment-theme-commands-shopify-cli) * December 10, 2025 Tags: * API ### [ShopifyQL Python SDK and CLI now available for analytics](https://shopify.dev/changelog/shopifyql-python-sdk-and-cli-now-available-for-analytics) New Python library simplifies ShopifyQL queries with a clean, Pythonic interface for analytics and data export. [Read full post –>](https://shopify.dev/changelog/shopifyql-python-sdk-and-cli-now-available-for-analytics) * December 10, 2025 Tags: * Admin GraphQL API * 2026-01 ### [New fields to combine bundle options](https://shopify.dev/changelog/new-fields-to-combine-bundle-options) Support merchants in combining options, such as size and length, so customers have fewer clicks to checkout. [Read full post –>](https://shopify.dev/changelog/new-fields-to-combine-bundle-options) * December 10, 2025 Tags: * API ### [Monitor admin performance issues by region with Web Vitals API](https://shopify.dev/changelog/monitor-admin-performance-issues-by-region-with-web-vitals-api) The Web Vitals API now includes country data for your app’s admin performance metrics, helping you identify and resolve region-specific performance issues in your apps. [Read full post –>](https://shopify.dev/changelog/monitor-admin-performance-issues-by-region-with-web-vitals-api) * December 10, 2025 Tags: * Shopify App Store ### [Simplified App Store requirements](https://shopify.dev/changelog/simplified-app-store-requirements) Get your app review-ready faster with streamlined Shopify App Store requirements and clearer documentation. [Read full post –>](https://shopify.dev/changelog/simplified-app-store-requirements) * December 10, 2025 Tags: * API ### [A more powerful Dev Assistant on shopify.dev](https://shopify.dev/changelog/a-more-powerful-dev-assistant-on-shopifydev) We have overhauled discovery on shopify.dev with a new AI-powered Dev Assistant. The new Assistant understands natural language queries, allowing you to describe what you are trying to build or solve. [Read full post –>](https://shopify.dev/changelog/a-more-powerful-dev-assistant-on-shopifydev) * December 10, 2025 Tags: * POS Extensions ### [Revamped POS UI extensions reference](https://shopify.dev/changelog/revamped-pos-ui-extensions-reference) The POS UI extensions reference is revamped with detailed guidance, new examples, clearer API relationships, and resolved feedback, enhancing integration ease for developers. [Read full post –>](https://shopify.dev/changelog/revamped-pos-ui-extensions-reference) * December 10, 2025 Tags: * Admin GraphQL API * Admin REST API ### [Offline access tokens now support expiry and refresh](https://shopify.dev/changelog/offline-access-tokens-now-support-expiry-and-refresh) Offline access tokens now expire in 60 minutes and include a refresh token for renewal, enhancing security and aligning with OAuth 2.0. Update token management to handle expirations. [Read full post –>](https://shopify.dev/changelog/offline-access-tokens-now-support-expiry-and-refresh) * December 10, 2025 Tags: * Platform ### [Introducing Sidekick app extensions](https://shopify.dev/changelog/introducing-sidekick-app-extensions) Introducing Sidekick app extensions for enhanced integration with Shopify's AI assistant. Enable data access, contextual queries, and safe actions within your app to improve merchant workflows. [Read full post –>](https://shopify.dev/changelog/introducing-sidekick-app-extensions) * December 10, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Advanced Metafield & Metaobject Querying](https://shopify.dev/changelog/advanced-metafield-metaobject-querying) Developers can now query Products, Orders, and Metaobjects using advanced Metafield filters like greater/less than, prefix, and boolean logic, streamlining resource searches. [Read full post –>](https://shopify.dev/changelog/advanced-metafield-metaobject-querying) * December 8, 2025 Tags: * Tools ### [New: Open source experimentation platform](https://shopify.dev/changelog/new-open-source-experimentation-platform) Tangle is an open-source platform for building ML/data pipelines with a visual editor, content-based caching, and reusable or custom modules, enhancing collaborative development. [Read full post –>](https://shopify.dev/changelog/new-open-source-experimentation-platform) * December 5, 2025 Tags: * Admin GraphQL API * 2026-01 ### [Order editing new validations and handled `userErrors`](https://shopify.dev/changelog/order-editing-new-validations-and-handled-usererrors) New order editing validations have been introduced [Read full post –>](https://shopify.dev/changelog/order-editing-new-validations-and-handled-usererrors) * December 2, 2025 Tags: * Admin GraphQL API * 2026-01 ### [InventoryItem.variant field deprecated in favor of InventoryItem.variants connection](https://shopify.dev/changelog/inventory-item-variant-field-deprecation) The InventoryItem.variant field is deprecated; switch to InventoryItem.variants for paginated connections. Update queries to handle edges and nodes for future compatibility. [Read full post –>](https://shopify.dev/changelog/inventory-item-variant-field-deprecation) * November 22, 2025 Tags: * Admin GraphQL API * Webhook * 2026-01 ### [Tax summary webhook and calculation requests now includes shop and presentment currency amount](https://shopify.dev/changelog/tax-summary-webhook-and-calculation-requests-now-includes-shop-and-presentment-currency-amount) API v2026-01 adds currency fields to `tax_summaries/create` webhook for shop and presentment currencies, enhancing multi-currency reporting and calculations for Tax Partner Apps. [Read full post –>](https://shopify.dev/changelog/tax-summary-webhook-and-calculation-requests-now-includes-shop-and-presentment-currency-amount) * 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 17, 2025 Tags: * Tools ### [Shopify Dev MCP now supports POS UI extensions](https://shopify.dev/changelog/dev-mcp-now-supports-pos-ui-extensions) The Shopify Dev MCP server now supports code generation for POS UI extensions [Read full post –>](https://shopify.dev/changelog/dev-mcp-now-supports-pos-ui-extensions) * November 13, 2025 Tags: * Tools ### [New Google Cloud Run deployment tutorial released](https://shopify.dev/changelog/new-google-cloud-run-deployment-tutorial-released) New tutorial for Shopify app deployment offers detailed guidance on production data storage, load balancer setup and multi-region deployment for Google Cloud Run. [Read full post –>](https://shopify.dev/changelog/new-google-cloud-run-deployment-tutorial-released) * 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) * 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) [Next](https://shopify.dev/changelog?page=2)