Developer changelog

New Admin GraphQL shippingLabelPurchase mutation lets apps buy Shopify Shipping labels asynchronously for fulfillment orders

The totalUnsettledSet field now correctly calculates unsettled amounts for pending captures, fixing a double-counting bug in multi-capturable orders. No code changes needed.

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

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 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.

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

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

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.

New APIs support multiple tiered rates for shipping options. Migrate to new fields to avoid issues. Legacy fields will be deprecated.

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

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.

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

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.

The deliveryShippingOriginAssign mutation is being deprecated.

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

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

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

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

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

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

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

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

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 refundCreate mutation now supports an optional processedAt field.

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.

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

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.

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

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

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

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.

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

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

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.

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

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.

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