Developer changelog

The MOST_RELEVANT value is now available to the GraphQL Admin API's CollectionSortOrder, available in API version...

The ActionBar is being removed on mobile. The primary action on the TitleBar now displays as an icon button — defaulting to a + (plus) icon if no icon is specified.

GraphQL Admin API now supports querying weight on LineItem, returning a Weight object with value and unit, simplifying access to line item weights. Available from API version 2026-07.

New CSS variable --shopify-safe-area-inset-bottom prevents content overlap with Shopify Mobile's bottom bar. Automatically adjusts padding; customize fixed elements using this variable. Live April 15, 2026.

A new testing library lets you write unit tests for UI extensions across all surfaces — Checkout, Admin, Customer Accounts, and POS — without a running Shopify host.

The grams field in DraftOrderLineItem is removed in API version 2026-07. Replace grams with weight for better flexibility and unit support to avoid errors in future queries.

We’ve made a number of changes to discount fields in the Storefront Cart GraphQL API for better clarity in discount allocations.

Shopify AI Toolkit connects supported AI coding tools to Shopify documentation, API schemas, code validation, store-management workflows, and migration guidance.

The Hydrogen April 2026 release updates to Storefront API 2026-04, makes the Storefront API proxy mandatory, and enables backend consent mode to replace the _tracking_consent cookie.

Shopify Functions now support discounts, shipping, and payments. Migrate from Shopify Scripts by April 15, 2026, as they will stop executing by June 30, 2026. Plan migration soon.

Replacing or deleting a file in the Shopify admin no longer purges its cdn.shopify.com/... URL; reference files via Shopify's URL helpers so the current versioned URL is always emitted.

Shopify POS now supports custom cash management with new GraphQL APIs and UI extensions. Features include shared cash drawers, enhanced financial data, reason codes, and bulk export capabilities.

Discount functions now support prerequisites for BXGY discounts, allowing developers to specify "Buy X" conditions.

API version 2026-04 introduces tags for discounts, enabling efficient labeling and organization.

The delegateAccessTokenCreate GraphQL mutation now returns an expiresIn field on the DelegateAccessToken type.

Added access field to StandardMetaobjectDefinitionTemplate for visibility of access rules, aiding developers in planning API interactions and ensuring smooth integration.

App-owned metaobjects now require no access scopes, simplifying developer use. Ensure Admin API version 2026-04+ for this feature. Merchant-owned metaobjects still need specific scopes.

Polaris reference docs now align with Shopify's GraphQL versioning, supporting each stable version for 12 months. Only the last four versions will have published docs starting 2026-04.

From GraphQL API v2026-04, Shopify Functions can access metaobject entries, enabling queries for structured data like tiered pricing and bundles using a handle or ID in input queries.

GraphQL Admin API now supports querying translated metafield values for any resource. Use the translations field to retrieve localized content. Supports text-based metafield types.

Adds a components field to DraftOrderLineItem. New optional flattenComponents argument defaults to false, affecting line item hierarchy.

API v2026-04 adds merchant_business_entity to tax_summaries/create webhook, detailing legal entity info for accurate tax calculations and cross-shop mapping. Optional field based on merchant setup.

API 2026-04 allows Tax Partner Apps to include up to 5 custom cart line item properties in tax calculations, enhancing merchant customization and data handling.

As of 2026-04, The fulfillmentOrderCancel mutation returns fulfillmentOrderCancelError with a code field, aiding developers in handling restrictions on in-progress fulfillment order cancellations.

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.

API v2026-04 adds billing address and PO number validation in Cart/Checkout Functions, enabling compliance checks without client-side UI. Existing functions remain unaffected.

Sales channel apps can now manage multiple connections within one app, each with distinct specs and accounts. New APIs support channel creation and management, enhancing flexibility and integration.

As of API v2026-07, customerPaymentMethodRemoteCreate requires a payment method ID for Stripe, Authorize.net, and Braintree. Update integrations to include these IDs.

In API 2026-04, paymentProcessingPolicy in subscriptionBillingAttemptCreate allows creating unpaid orders without valid payment methods.

The productUpdate mutation now accepts an identifier argument for looking up products by id, handle, or customId.

API v2026-04 allows 3PLs and apps to report fulfillment order progress using fulfillmentOrderReportProgress. Supports status notes for OPEN/IN_PROGRESS orders, enhancing merchant visibility.

In API 2026-04, paymentMethodId is optional for subscription contract creation, easing migration of contracts with missing or expired payment methods to Shopify.

Starting 2026-04, fulfillmentOrderMove mutation updates userError type, adding a code field for error identification. New feature restricts moving orders with reported progress.

RBAC and a new organization structure for partner orgs. All stores in Dev Dashboard. Auto-migration starting March 30th - no action required.

The visibleToStorefrontApi field is deprecated and removed. Use the access field on metaobject definitions.

Shopify CLI will remove the --force flag in May 2026 to prevent accidental app extension deletions. Update CI/CD scripts to use --allow-updates for safer deployments.

Customer data erasure requests will process 10 days after submission, regardless of last order date; gift card recipients remain pending until delivery.

The pre_tax_price fields in REST Admin API are removed. Use GraphQL Admin API for order line item pricing. Avalara AvaTax 1.0 integration deprecated April 2025.

Version 2026-04 adds barcode support to inventory shipments, enabling faster receiving. New API fields and mutations allow assigning, setting, or clearing unique barcodes up to 255 characters.

Starting April 1, new public apps must use expiring offline access tokens to improve security. This affects only public apps using the Admin API with non-expiring tokens, not merchant or custom apps.

Shopify apps must process refunds via the original payment processor. Use 'refundCreate' or 'returnProcess' for store credits to ensure secure, consistent handling within Shopify.

Admin intents now support direct access to Shopify Settings pages via API calls, streamlining merchant navigation and enhancing app integration with specific settings like StoreDetails and Locations.

POS UI extensions now run without network access. Enable by setting runs_offline = true. Requires POS v11.0+ and Shopify CLI v3.92+.

The inventoryTransferDelete mutation returns INVALID_STATE error in 2026-07 if a product import is in progress. Older versions lack this code but include context in the message field.

The fieldDefinitions input argument of the metaobjectDefinitionCreate mutation will become optional in 2026-04.

The createdAt and updatedAt fields will become available in API version 2026-04

Payments Apps API now offers detailed decline codes and a source field for rejected payments, aiding developers in providing precise feedback to merchants. RISKY code deprecated; use FRAUD_SUSPECTED.

When you query the OrderTransaction.errorCode field, you can now access detailed information about specific decline reasons, enabling you to handle each scenario appropriately.

Returns fields in analytics are deprecated and replaced with renamed versions (e.g., sales reversals) in API version 2026-04 to better reflect all order adjustments; update your queries before removal

New development shops have access to checkout and customer account UI extensions by default. Existing shops remain unchanged.