Developer changelog

POS UI Extensions update: Fixed component rendering, removed FormattedTextField, added properties to interfaces, deprecated Icon props, and introduced Storage API for data storage.

The subtotal_price field is added to Server Pixel events: checkout_started, payment_info_submitted, and checkout_completed.

The new App Bridge Reviews API allows Shopify apps to request reviews directly within the Shopify admin interface.

Cart tokens have changed format

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.

Starting July 1, 2025, new category-specific requirements for marketing apps in the Built for Shopify program will be enforced during initial and annual reviews.

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.

Previously, subscription discount data was only available through the GraphQL Admin API. Now, it's also available through the Customer Account API.

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.

Update Buy Button JS by August 1, 2025, to maintain functionality. Ensure your Buy Button JS code is updated with the latest version.

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

The new unit_price_with_measurement filter displays unit prices in the customer's language, enhancing UX and simplifying code. Available for stores in the European Union and Switzerland only.

In API version 2025-07, we've standardized target and operation names across various Function APIs. The previous target and operation names still work, too.

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.

The 2025-07 version of Function APIs adds the cart.deliveryGroups.groupType type to identify a delivery as a one-time purchase or part of a subscription.

Shopify Functions now support reading cart metafields in GraphQL queries. Checkout UI extensions can also read and write cart metafields for various cart states. Use reserved namespaces for security.

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.

The 2025-07 Functions API lets you set custom payment terms at checkout using PaymentTermsSetOperation.

Liquid and Storefront GraphQL API now limit pagination to 25,000 items, and Liquid page size was increased to 250. Admin API limits are unchanged.

Shopify will no longer set _shopify_country on storefronts from Aug 15, 2025. Use Customer Privacy API's getRegion method to determine customer location.

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.

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.

Individual theme presets can now be installed, matching demo store setups. Submit updated theme files for approval to enable this.

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.

You can now recommend specific theme blocks in the block picker.

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.

150+ new features, good vibes

The latest version of Hydrogen, 2025.5.0 is out today. With this release, Hydrogen is upgrading from Remix 2 to React Router 7. Follow the upgrade guide shared in our Hydrogen May 2025 release blog...

Select apps and AI agents can access Shopify’s global product catalog to surface detailed product information including pricing, options, and availability in real-time.

We’ve improved the recommendation algorithm for large merchants to better surface apps installed and liked by similar-sized businesses.

In addition to where personalized results are currently...

We've optimized Shopify App Store search for Japanese, Chinese, Korean, and Thai, allowing global merchants to discover apps faster and easier. Updates include:

• Better synonym and character...

Serve your app on localhost with a self-signed HTTPS certificate using Shopify CLI.

We've aded Shopify Functions support to the Dev Assistant and our MCP server, enabling AI-driven code generation, JavaScript-to-Rust code conversion, and Function API guidance.

New reference documentation for the Shopify Function APIs offer end-to-end examples, interactive GraphQL exploration, visual diagrams, and performance metrics.

The new retailLocation field in Function APIs enables context-aware logic for Shopify POS, allowing location-based discounts and store-specific rules.

The visible_if Liquid property lets you hide irrelevant theme settings in the Theme Editor.

Polaris web component support is now in early access on Shopify Dev MCP.

Polaris is now a unified, smaller, faster, framework-agnostic web component toolkit for Shopify, accessible via CDN, enhancing development across Admin, Checkout, and Customer Accounts.

Develop and test post-purchase checkout extensions directly via shopify app dev, eliminating the need for a Chrome extension, streamlining workflow and enhancing extension development consistency.