Developer changelog

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

The multipassIdentifier field is now available in the Admin GraphQL API for customerCreate and customerUpdate mutations, providing feature parity with the REST Admin API.

The 2025-10 API update returns an error on false for permitsSkuSharing in fulfillmentServiceCreate and FulfillmentService#create, deprecating non-SKU sharing services.

In version 2025-10, collectionReorderProducts mutation's userErrors type changes to CollectionReorderProductsUserError, adding a code field for enhanced error handling.

API version 2025-07 allows filtering Order.fulfillments by created_at and updated_at using familiar query syntax, enhancing search precision without altering default behavior.

The orderCancel mutation now allows refunds to be issued to store credit. A new refundMethod input deprecates the existing refund input, providing greater flexibility.

New DraftOrderMarketRegionCountryCodeNotSupportedWarning added for DraftOrder. Warns if deprecated marketRegionCountryCode is set, as it doesn't affect draft orders on shops using Markets.

Added minRange and maxRange fields to segment filters in the Admin GraphQL API to expose valid value ranges for customer segmentation.

Starting July 2025, third-party apps can self-uninstall via a new GraphQL mutation.

New GraphQL fields let you view return timestamps and track quantities through processing.

New removeFromReturn mutation lets Partners remove unprocessed return and exchange items, replacing the older mutation. Available in unstable and 2025-07 GraphQL API versions.

API version 2025-07 includes new fields to help you process returns

API version 2025-07 increases draft order line item limit from 250 to 499

API 2025-07: Fulfillment service apps can now use estimatedShippedAt to specify estimated fulfillment order completion, enhancing shipment tracking accuracy for merchants.

The EligibleForShopifyTaxReporting and ShopifyTaxReportingLegacyAutoTaxMigrated fields are removed from ShopFeatures. Update integrations as no replacements exist.

Image alt text is now translatable, allowing developers to register translations via the Translations API.

Update client libraries to include Content-Length or Transfer-Encoding: chunked in POST requests by August 1, 2025, to avoid HTTP 411 errors.

New groupObjects argument in GraphQL Admin API allows disabling object grouping for faster, more reliable bulk operations by setting it to false.

Shop metafields are now visible in the Admin UI, eliminating custom interface development. Developers can easily build apps using shop-level data with built-in viewing and editing capabilities.

API version 2025-10 improves order editing with direct session access via OrderEditSession.id, flexible mutation ID support, and enhanced return fields for better workflow tracking.

From 2025-07, productCreate will return userErrors for duplicate or conflicting metafield links, invalid linkedMetafieldValue or optionValues specifications, and conflicting option parameters.

Adds fields for device, location, and currency exchange in OrderTransaction; and a processed_at field in OrderCreateManualPayment to manually specify payment time.

Added FREE_GIFT_CARD_NOT_ALLOWED to SubscriptionBillingAttemptErrorCode enum, preventing subscriptions from including gift cards sold at a zero price.

Product review syndication is now generally available, allowing partners to build apps displaying product reviews across Shopify, provided they meet program requirements.

API version 2025-10 changes fallback for pricing and publishing to use backupRegion settings, ensuring consistency across APIs. Previous versions use store defaults.

GraphQL now includes orderCustomerRemove and orderCustomerSet mutations and an Order.number field, so you can manage customers on orders programatically.

The rate service now treats HTTP 3xx/4xx errors as recoverable, using backup rates to ensure shipping options display, enhancing checkout reliability and safeguarding conversion.

Adds a title filter to the articles Admin API query.

The Order Edit API allows you to edit line items containing selling plans before an order ships.

GraphQL count APIs now return uncapped results with limit=null. All APIs standardized; limit defaults to 10000, introducing a breaking change.

Starting May 20, 2025, apps can refund to store credit regardless of original payment. Store credit is visible in customer profiles and accessible via GraphQL Admin API.

You can now allocate refunds as new store credit alongside original payment methods. Requires new customer accounts and customer-associated orders.

New API endpoint retrieves delivery options for draft orders, including shipping rates and local pickup, with pagination. Requires read_draft_orders access scope. Replaces legacy field.

Metafields access is changing: PUBLIC access is removed, now set to MERCHANT_READ_WRITE. Migrate to a custom namespace if other apps need read access.

Shopify is retiring gates types and fields in favour of metafields and metaobjects for better custom data management across Admin, Storefront, and Functions APIs.

The release candidate for version 2025-07 of the Storefront, GraphQL Admin, and Customer Account APIs now support imperial units and count measurements, enabling more transparent pricing.

Shopify's GraphQL now supports retrieving Shop Pay payment details using source_identifier or receipt token, streamlining workflows for merchants using Shop Component.

API version 2025-07 deprecates the draftOrderCreateMerchantCheckout mutation.

Order status URLs now use capability tokens instead of static keys, improving security with limited uses and automatic expiration. Optional parameters available for customization.

productSet mutation returns more precise PRODUCT_SUSPENDED error code

The publicDisplayName field is added to ShopPlan. The Shopify plan is now Grow. Update to publicDisplayName as displayName will be deprecated.

Automatically create smart collections with the new PRODUCT_CATEGORY_ID_WITH_DESCENDANTS field.

Inventory Transfers developer preview is now available, allowing you to test enhanced multi-location inventory management features and build integrations for complex inventory movements.

Stable API versions now retroactively add GraphQL Enum values. Refresh introspection caches and implement catch-alls to avoid toolchain disruptions.

We've added new FulfillmentOrderRejectionReason enum values for more detailed error messages.

Added rfmGroup field to customer statistics in the Admin GraphQL Admin API to expose customer segmentation data based on purchasing patterns.

The draftOrderCount query is now available in the 2025-07 stable version of the GraphQL Admin API. Previously, it was...

Added new enum values to CustomerPaymentMethodRevocationReason: CUSTOMER_REDACTED, TOO_MANY_CONSECUTIVE_FAILURES, CVV_ATTEMPTS_LIMIT_EXCEEDED

The themeFilesUpsert mutation now returns theme file metadata directly, eliminating the need for extra fetch requests to verify updates.

location.id can now be queried with read_inventory or read_locations scopes. Other Location fields still need read_locations. Applies to all API versions.