Developer changelog

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.

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

The deliveryShippingOriginAssign mutation is being deprecated.

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

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.

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

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

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

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.

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

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.

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

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.

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

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.

The 2026-01 API adds taxSummaryCreate mutation for generating tax summaries and tax_summaries/create webhook for tax events. Requires write_taxes scope and Tax Platform access.

The Carrier Service API now includes order_totals and customer tags in callbacks, enabling more precise shipping rate calculations based on order value and customer segmentation.

Admin API 2026-01 update: phone field in orderUpdate mutation's OrderInput is now public, enabling developers to update customer phone numbers, aligning with REST API capabilities.

New GraphQL queries bulkOperations and bulkOperation enhance bulk operation management with filtering, sorting, and pagination, improving visibility and debugging in the Admin API.

GraphQL Admin API bulk operations are now faster and more reliable. groupObjects defaults to false for queries and is deprecated for mutations. Adjust settings for grouped output if needed.

Inventory transfers can now omit origin or destination IDs, enhancing flexibility. Update app validation to treat these fields as optional. Existing apps remain unaffected.

The 2026-01 Admin GraphQL API adds ACH payment support, introducing BankAccount to PaymentInstrument and CustomerPaymentInstrument unions, enhancing B2B payment management.

Increased metafield and metaobject limits: 256 app definitions, 256 merchant definitions, and 1M entries per definition, supporting complex data models and workflows.

The storeCreditAccountCredit mutation now accepts an optional notify parameter. When set to true the account owner will be sent a 'store credit issued email'.

Admin API 2026-01: callbackUrl in fulfillmentServiceCreate and fulfillmentServiceUpdate is now optional. Existing fulfillment services will be unaffected.

Legacy mode profiles are no longer supported.

The fulfillmentOrdersReroute mutation in the Admin GraphQL API lets developers reroute orders based on delivery strategies, enhancing flexibility and consistency.

Shopify Admin API updates: returnRefund deprecated, replaced by returnProcess for streamlined return management. Available now in unstable, official release in 2025-07.