Developer changelog

New error INVALID_BILLING_ADDRESS for subscription billing attempts flags invalid billing address fields.

Added ON_FULFILLMENT to SellingPlanRemainingBalanceChargeTrigger to set payment for pre-orders due upon order fulfillment.

API version 2026-01 introduces shopAddress in Shop object, replacing billingAddress. Update queries to use shopAddress for future compatibility. Structure remains unchanged.

As of API version 2026-01, the Storefront API returns GIFT_CARD_RECIPIENT_INVALID error for invalid gift card recipient details, aiding error handling in cart operations.

In API version 2026-01, Venmo and PayPal are separate in payment customization. Update logic to hide Venmo independently from PayPal for desired behavior.

inventorySetQuantities now supports a cleaner way to handle concurrent updates. Use the new changeFromQuantity field instead of the deprecated compareQuantity and ignoreCompareQuantity fields.

Idempotency keys are now available on refund and inventory mutations starting in API version 2026-01, enabling safer request retries and preventing duplicate operations.

The changeFromQuantity field ensures inventory data stays accurate, even if you're making multiple adjustments at the same time.

Build tests from real production data and catch breaking changes before they hit production with comprehensive binary testing for Shopify Functions.

Run theme commands across multiple stores at once. Push, pull, or publish to dev, staging, and production environments in a single operation.

New Python library simplifies ShopifyQL queries with a clean, Pythonic interface for analytics and data export.

Support merchants in combining options, such as size and length, so customers have fewer clicks to checkout.

Get your app review-ready faster with streamlined Shopify App Store requirements and clearer documentation.

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.

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.

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.

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.

New order editing validations have been introduced

The InventoryItem.variant field is deprecated; switch to InventoryItem.variants for paginated connections. Update queries to handle edges and nodes for future compatibility.

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.

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.

The Shopify Dev MCP server now supports code generation for POS UI extensions

New tutorial for Shopify app deployment offers detailed guidance on production data storage, load balancer setup and multi-region deployment for Google Cloud Run.

Third-party tax apps now receive Global IDs for entity identification, aligning with Shopify's GraphQL Admin API standards.

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.

The 2026-01 API adds taxSummaryCreate mutation for generating tax summaries and tax_summaries/create webhook for tax events. Requires write_taxes scope and Tax Platform access.

The Carrier Service API now includes order_totals and customer tags in callbacks, enabling more precise shipping rate calculations based on order value and customer segmentation.

Admin API 2026-01 update: phone field in orderUpdate mutation's OrderInput is now public, enabling developers to update customer phone numbers, aligning with REST API capabilities.

Enable standard metafield/metaobject definitions via TOML for faster, atomic updates across shops, enhancing migration speed and consistency in app development and deployment.

New GraphQL queries bulkOperations and bulkOperation enhance bulk operation management with filtering, sorting, and pagination, improving visibility and debugging in the Admin API.

In the GraphQL Storefront API 2026-01 release, cartDiscountCodesUpdate now requires the discountCodes argument.

Built for Shopify certified apps now receive prominent placement on the App Store homepage and in app recommendation sections on some category pages, making BFS apps easier for merchants to discover.

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.

Inventory transfers can now omit origin or destination IDs, enhancing flexibility. Update app validation to treat these fields as optional. Existing apps remain unaffected.

The 2026-01 Admin GraphQL API adds ACH payment support, introducing BankAccount to PaymentInstrument and CustomerPaymentInstrument unions, enhancing B2B payment management.

Increased metafield and metaobject limits: 256 app definitions, 256 merchant definitions, and 1M entries per definition, supporting complex data models and workflows.

Apps can use branding in theme extensions only if it enhances the buying experience or prevents confusion. Otherwise, use standard attribution. No review requests or app promotions allowed.

The storeCreditAccountCredit mutation now accepts an optional notify parameter. When set to true the account owner will be sent a 'store credit issued email'.

The Cart AJAX API and Storefront Cart GraphQL API now process simultaneous requests.

Major update to POS UI Extensions: Hot reloading improvements, quick previews, build error reporting, auto dev console, app persistence, and in-app reset enhance developer workflow and efficiency.

All merchants can now create up to 2,048 variants per product in Shopify admin.

POS UI Extensions 2025-10 introduces APIs for managing subscription selling plans in Shopify POS.

Shop Minis SDK early access available. Shop Minis SDK offers immersive buyer experiences in the Shop app using React. Create Minis with npm init @shopify/shop-mini@latest for quick setup.

Admin API 2026-01: callbackUrl in fulfillmentServiceCreate and fulfillmentServiceUpdate is now optional. Existing fulfillment services will be unaffected.

Give customers the option to use Shop Pay and Apple Pay on cart and product pages in your mobile app.

Legacy mode profiles are no longer supported.

Each theme now uses one industry tag instead of two. Ensure your primary tag matches your theme's main demo designs and target merchant base.

The fulfillmentOrdersReroute mutation in the Admin GraphQL API lets developers reroute orders based on delivery strategies, enhancing flexibility and consistency.

Shopify.dev MCP Now supports Polaris, Liquid and all GQL APIs.

Subscription contracts now sync shipping requirements from product variants and skip delivery lines for digital orders, ensuring accurate taxes and totals.