Developer changelog

Avoid using OrderTransaction.receiptJson due to its instability and inconsistent structure. Migrate to stable fields to prevent app failures.

Admin UI extensions for Discount Functions can now interact with the selected discount method and manage discount classes.

POS version 10.19.0 now displays an error page for unhandled callback errors. Developers must test callbacks to ensure all exceptions are properly handled and prevent merchant disruptions.

Access to events data over a year old is removed from Admin GraphQL and REST APIs. Update dependencies to ensure compatibility. This change enhances data management and system performance.

Subscription apps can now let buyers update their payment method in-context using the new Intents API for customer account extensions.

Checkout UI extensions that support blocking will now default to non-blocking behavior. Merchants must explicitly activate blocking behavior.

Theme developers can now use the article_list setting type to let merchants select multiple blog articles for sections and blocks.

Localize POS UI extensions with translation, currency, and pluralization support. Automatically resolve translations based on customer or shop locale for international merchants.

The shopify.app.extensions() method now supports Admin and Storefront extensions, enabling comprehensive onboarding and dashboards across all app extension surfaces.

POS version 10.19.0 introduces a Camera API for POS UI extensions, allowing access to the device camera for scanning IDs, capturing product photos, and attaching images in POS.

Shopify CLI 3.89 adds --allow-updates and --allow-deletes flags for safer app deployment control in CI/CD. Use --allow-updates to avoid accidental data loss.

Shopify CLI v3.89 introduces shopify app import-custom-data-definitions for migrating app metafield/metaobject definitions to TOML, ensuring consistent, version-controlled deployments.

API version 2026-04 introduces MERCHANDISE_LINE_TRANSFORMERS_RUN_ERROR for Cart Transform Function runtime errors, improving error handling and debugging in cart operations like cartCreate.

In API 2026-04, inventoryActivate now preserves existing active and onHand quantities if available or onHand aren't provided, preventing unwanted resets to zero.

Shop Minis CLI now requires "Manage apps" permission in Partner accounts for setup and submissions. Developers must request access from admins to avoid errors.

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.

Shopify is enforcing stricter Liquid parsing for all themes to improve reliability and enable future Liquid improvements.

Asset URLs now use ?v=VERSION_STRING for versioning. Update code parsing URLs to support this format, replacing assumptions about numeric-only query strings.

The deliveryShippingOriginAssign mutation is being deprecated.

The Admin GraphQL API now includes a transactions connection in the Return object, simplifying payment/refund associations for returns, enhancing financial reporting accuracy.

API v2026-01 adds an orders/link_requested webhook, notifying subscribed apps when customers request new order links from expired Order status pages.

A new ReturnReasonDefinition type replaces ReturnReason, providing category-specific return reasons for better analytics and improved return experiences.

We're introducing throttling for billing attempts, with errors visible in the throttled code on the BillingAttemptUserErrorCode code.

New fields in MarketingEngagementCreate enhance data integration for marketing metrics, supporting diverse conversion tracking and analytics in Shopify's reports.

In API version 2026-04, permitsSkuSharing is removed from FulfillmentService. Permits SKU sharing will be enabled by default.

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.

The Discount Function API now lets merchants reject discounts with custom messages, preventing double discounts, managing code combinations, and disqualifying products.

The refundCreate mutation now supports an optional processedAt field.

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

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.

From API version 2026-01, authorizationCode in OrderTransaction is deprecated. Use paymentId for stable payment tracking. Update queries to replace authorizationCode with paymentId.

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.

The changeFromQuantity field is now mandatory; use null to bypass checks. compareQuantity and ignoreCompareQuantity fields are removed, impacting inventory mutation handling.

Starting April 2026, idempotency is mandatory for specific Shopify mutations to prevent duplicate inventory adjustments and refunds, enhancing integration robustness and reducing errors.

New concurrency protection features: changeFromQuantity field and idempotent directive will be required for inventory and refund mutations. Breaking changes.

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.

150+ updates for the commerce renaissance.

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.

The POS UI extensions reference is revamped with detailed guidance, new examples, clearer API relationships, and resolved feedback, enhancing integration ease for developers.

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.

Developers can now query Products, Orders, and Metaobjects using advanced Metafield filters like greater/less than, prefix, and boolean logic, streamlining resource searches.

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.

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.