Developer changelog

New Checkout & Accounts Configuration API enables unified branding across checkout, customer accounts, and sign-in with shared settings, surface overrides, direct color settings, and Markets support.

Version 2026-04 of the GraphQL Admin API now supports multiple product discounts per cart line, aiding merchants in migrating Scripts before the June 30, 2026, sunset date.

Checkout metafields are deprecated as of API version 2026-04. Migrate to cart metafields in checkout UI extensions and order metafields in customer account UI extensions.

API version 2026-04 adds isActive to InventoryLevel, allowing queries for inactive levels without clearing quantities. Use isActive to filter results and update logic accordingly.

API v2026-04 introduces includeInactive: true for inventoryLevels queries, allowing retrieval of inactive inventory. Default remains active-only, ensuring existing queries are unaffected.

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

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.

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.

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.

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

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

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.

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

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

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.

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.

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.

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.

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.

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

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.

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.

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

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

As of version 2026-04, we removed the id field from checkouts webhooks and the checkout_id field from orders webhooks. From now on, use the checkout token to reference a checkout.

The analyticsQueryable feature in GraphQL Admin API lets developers enable metafields for Shopify Analytics, enhancing data analysis for Products, Product Variants, Orders, and Customers data.

In GraphQL API v2026-04, Shopify Functions can now access discount details at cart, line item, and delivery levels, but only if they execute after discounts are applied.

The GraphQL Admin API now includes SubscriptionBillingAttemptState, replacing several fields with a discriminated union for better ergonomics and self-documentation.

The Payments Apps API now supports new rejection codes and an optional merchant message, enhancing control over verification rejections with moredetailed reasons and custom feedback.

JSON metafield values will be capped at 128KB beginning with API version 2026-04.

A new remainingLineItemsWeight field has been added to the FulfillmentOrder GraphQL type.

Added 3 enum values to ColumnDataType: RATING (float), STRING IDENTITY (GID/UUID), COLOR (HEX). Enhances data representation flexibility for developers.

Assign optional names to webhook subscriptions for easier management. Names appear in request headers, aiding routing. Unique per shop/app, up to 50 chars, set via TOML or Admin API.

Query gift card expiration settings via GraphQL Admin API. New expirationConfiguration field provides duration and unit, aiding in calculating expiration dates for gift cards.

New payment error codes in Admin GraphQL API enhance diagnosis. Unstable API version shows fewer generic errors. Temporary error mapping issue fixed.

Order metafield definitions now support cartToOrderCopyable. When enabled, cart metafield values copy to the matching order metafields at checkout completion.

We've added a tracks_inventory filter for querying products by inventory tracking status.

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.

The deliveryShippingOriginAssign mutation is being deprecated.

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

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.

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