Developer changelog

2026-10 Admin API removes DraftOrderDiscountNotAppliedWarning.priceRule and PriceRule types. Update queries to use discountTitle and discountCode instead.

ITEM_NOT_STOCKED_AT_LOCATION error removed from inventory APIs in 2026-10. Apps can drop handling for this obsolete error as inventory is adjustable at any location.

The appliesOnSubscription and appliesOnOneTimePurchase fields on app discounts are now enforced at checkout. Existing discounts are unaffected.

New Admin GraphQL 2026-07 field coversAllItems for app-owned shipping delivery profiles lets authorized apps apply rates to all shippable items without per-product assignment

Admin GraphQL API 2026-07 allows defining and setting metafields directly in inventory transfers, streamlining custom data integration without separate metafieldsSet calls.

Shopify bulk queries are now up to 4X faster for exporting large datasets.

API 2026-07: GraphQL Admin adds channel markets. Create, update, and query markets per sales channel for channel-specific availability, pricing, and currencies.

New APIs let you read and update WhatsApp marketing consent on a customer’s default phone via customerWhatsAppMarketingConsentUpdate and the CustomerPhoneNumber consent field

2026-07 adds a new Collection model with multiple product group sources, shareable app-owned sources, and variant-level collection membership; migrate from ruleSet and legacy collection input.

New Metaobject values property enables simplified reads/writes with automatic conversion to/from JSON objects

In GraphQL Admin API v2026-07, GiftCardCashOutTransaction is added to distinguish cash-out adjustments from debits. Query giftCard.transactions using __typename to identify them.

API v2026-07 adds local currency gift cards via GraphQL Admin API. Use giftCardProductSet for creation, set issuanceCurrency, manage cross-currency redemption, and query settings.

New inventory transfer webhooks include origin and destination fields. Documentation for inventoryTransferSetItems and inventoryTransferRemoveItems is clarified. Error messages are more descriptive.

Starting Jan 1, 2027, all public apps must use expiring offline access tokens for Admin API calls to enhance security. Migrate from non-expiring tokens to avoid authentication errors.

MetaobjectAdminAccess enums PRIVATE and PUBLIC_READ are deprecated and removed in 2026-07

You can query shippingLine on FulfillmentOrderLineItem, aiding apps in identifying shipping methods for merged fulfillment orders.

The GraphQL Admin API's Order object now includes the checkoutToken field, aligning with REST API, to access the checkout token used for order creation.

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.

The GraphQL Admin API now includes the cartToken field in the Order object, allowing developers to access the cart token used to create an order, similar to the REST API.

You can now create discounts that are eligible for specific markets, giving you better control over which buyers can access your discounts based on region, B2B company location, or retail location.

ProductVariant is now Publishable allowing fine-grained control over visibility per channel. Variants default published, channels/feeds that do not use product feed should implement support.

Checkout now supports ship and pickup in a single order. If your app reads, calculates, or displays delivery and fulfillment information, test and update them now.

The appliesOnSubscription default is now true in Admin GraphQL API inputs. No action required.

A new actor field in subscription mutations tracks action initiators (customer, merchant, partner).

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.

GraphQL Admin API now supports creating, updating, reading, and deleting merchant metric targets, enhancing analytics integration for goal-setting, reporting, and planning apps. Requires specific permissions.

The Admin GraphQL API's LineItem now has priceAfterAllDiscountsBeforeTaxesSet, showing line item prices post-discount, pre-tax, aiding order export workflows.

Apps can now read a customer's tax ID (VAT number) via the Admin GraphQL API using Customer.taxSettings.taxId, starting in API version 2026-07.

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.

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

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.

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.

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.

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

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

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.

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.

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.

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

The inventorySetScheduledChanges mutation is being removed with no replacement. Remove its usage to prevent disruptions. Consider inventoryAdjustQuantities for immediate inventory updates.

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.