Developer changelog

Order metafield filters in Shopify Admin UI and GraphQL API enhance order management, allowing precise data retrieval and improved operational efficiency for developers and merchants.

Store credit accounts now support company locations, enabling location-specific credit management. B2B customers can view and use credits at checkout. APIs updated for credit queries and transactions.

The customerPaymentMethodRemoteCreate mutation now has rate limiting to control API usage, ensuring stable performance for all merchants.

As of Aug 26, 2025, exchangeLineItems and return fees are supported for new Facebook orders via returnCreate mutation, simplifying exchanges. Not applicable to prior orders.

The FulfillmentEventStatus enum now includes CARRIER_PICKED_UP, allowing merchants to track when carriers collect shipments.

Version 2025-10 allows metaobject fields to include capabilities like admin_filterable, enabling filtering in Shopify admin.

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

As of 2025-10, set countryCode in CountryHarmonizedSystemCodeInput to null to set a global harmonized system code.

New ProductVariantsBulkCreateStrategy to enhance productVariantsBulkCreate capabilities

The order editing API now supports applying discounts to fulfilled line items, allowing for more accurate financial attribution and reporting.

New guidelines for referenceDocumentUri in inventory adjustments enhance traceability. Supports multiple URI formats, and includes best practices, examples, and migration guides.

Shopify is removing the "Sell from all locations" fulfillable inventory option, requiring shops to configure shipping zones. Apps must ensure inventory is available for delivery to avoid errors.

The orders query now supports current_total_price and total_weight filters, plus sortKey can use CURRENT_TOTAL_PRICE, enhancing data retrieval and sorting options for developers.

GraphQL Admin API 2025-10 adds externalTraceId to ShopifyPaymentsPayout, providing the financial institution's reference number for payout tracking.

The taxCode field in ProductVariant is deprecated as of API version 2025-10. Update your app to remove dependencies on this field due to Avalara AvaTax app discontinuation.

Inventory shipment timestamps are now accessible via the Admin GraphQL API. Use dateCreated, dateReceived, and dateShipped fields.

Added dispute_type filter to OrderListData GraphQL query, enabling filtering of orders by chargeback and/or inquiry.

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

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

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 discountClass field is deprecated; use discountClasses for multiple discount classes. Continue using presentationLevel to see DraftOrderPlatformDiscount effects.

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 increases draft order line item limit from 250 to 499

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

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

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.

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.

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

Adds a title filter to the articles Admin API query.

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

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

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.

API version 2025-07 deprecates the draftOrderCreateMerchantCheckout mutation.

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

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