Developer changelog

Each theme now uses one industry tag instead of two. Ensure your primary tag matches your theme's main demo designs and target merchant base.

Shopify Functions now support user-defined handles in GraphQL mutations, simplifying deployment by removing the need to query for functionId. Existing functionId usage remains supported.

GraphQL Admin API 2025-10 adds usdcRebateCreditAmount to ShopifyPaymentsPayoutSummary, providing a total of all usdc rebate credits issued as part of the payout.

As of version 2025-10 of the GraphQL Storefront API, Cart now supports adding gift cards without replacing already applied gift cards.

Shopify.dev MCP Now supports Polaris, Liquid and all GQL APIs.

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

The inventoryShipmentReceive mutation now supports an idempotencyKey to prevent duplicate inventory adjustments, ensuring consistent inventory levels and data integrity during repeated requests.

Subscription contracts now sync shipping requirements from product variants and skip delivery lines for digital orders, ensuring accurate taxes and totals.

Polaris web components are now generally available, supporting Admin, Checkout, Customer Accounts, and POS surfaces via Shopify's CDN.

The productSet mutation now enforces validation limits on inventory quantities as part of supporting the increased variant limit from 100 to 2048 variants per product.

The productCreate and productUpdate mutations now use dynamic complexity costing that more accurately reflects the actual computational cost of operations.

The productVariantsBulkCreate and productVariantsBulkUpdate mutations now validate limits on inventory quantities to support increased variant limit from 100 to 2048 variants per product.

The productVariantsBulkCreate and productVariantsBulkUpdate mutations now use dynamic complexity costing that more accurately reflects the actual computational cost of operations.

The productSet mutation now uses dynamic complexity costing that more accurately reflects the actual computational cost of operations.

Adds query field shopifyqlQuery to GraphQL Admin API

The new themeDuplicate mutation in Admin GraphQL API allows you to duplicate themes (and optionally rename the duplicate).

From October 31 2025, updating a shipping address in Draft Order checkout may alter prices based on Markets settings. Use priceOverride or generatePriceOverride to maintain prices.

The new admin intents API allows apps to easily create or edit Shopify resources like products & customers via a single API call, revolutionizing how apps interact with Shopify's admin interface.

Shopify extends the grace period for BFS apps not meeting criteria to 60 days, giving developers time to fix issues while retaining the BFS status.

Shopify's Admin GraphQL API now supports article_reference and list.article_reference metafield types, enabling dynamic content linking and improved store customization.

Remote products can now be displayed on storefronts. Update Cart Ajax API logic to exclude remote items for shipping, discounts, and recovery. Remote items aren't supported in Shopify Functions.

New opt-in feature allows storefronts to display remote products from other stores. No theme updates needed, but app integrations may be affected. Remote products require a specific template.

Adds a new 'prevented' status for Disputes and updates the description of all dispute statuses.

You can now access more detailed balance information and due status for payment schedules with three new fields: balanceDue, totalBalance, and due.

Merchants can now find, compare, and install apps via Sidekick.

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.

Polaris update: Eight new Admin components (ColorField, ColorPicker, Popover, Tooltip, Menu, Chip, ClickableChip, DropZone) now available via Shopify CDN.

Update your app to the latest Checkout Kit (Swift 3.3.1, Kotlin 3.5.1, React-native 3.3.1) to ensure compatibility with iOS 26 and prevent checkout issues.

Create dev stores on any plan, use app dev preview for instant iteration, manage metaobjects in code, and utilize the new Dev Dashboard for streamlined app management and migration.

The @inContext directive now supports visitorConsent for buyer preferences, auto-encoding consent into checkoutUrl, ensuring privacy compliance in Storefront API v2025-10+.

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

Build announcement bar extensions on Thank You and Customer Account pages using the 2025-07 UI APIs. Capture buyers' attention for tasks like surveys, reviews, upsells and more.

The profiles/update webhook now includes fields like name, default, profile_type, and version, improving update reliability and reducing debouncing for rapid profile changes.

New ProductVariantsBulkCreateStrategy to enhance productVariantsBulkCreate capabilities

Starting August 2025, deprecated fonts in themes, checkout, and Shopify Forms will be automatically replaced with similar-style alternatives.

The checkout_and_accounts_configurations/update webhook will be deprecated on Jan 1, 2026. Use the Admin API checkoutProfiles query for tracking updates instead.

New fields have been introduced to enable parent-child (nested) relationships between cart lines, supporting use cases such as warranties, engravings, and gift-wrapping.

Export search term performance data with detailed targeting for multiple campaigns at once, including breakdowns by country, device, and shop plan, from the ads campaigns overview page.

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

Starting Sept 15, 2025, Shopify stops setting _landing_page, _orig_referrer, _tracking_consent cookies. Update code to use browser APIs or Shopify APIs for these values.

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.

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