Developer changelog

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.

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 Buy Button JS by August 1, 2025, to maintain functionality. Ensure your Buy Button JS code is updated with the latest version.

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.

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

Shopify Functions now supports 25 active functions per API, up from 5, enabling developers to better organize logic for payments, delivery, and cart and checkout validations.

Starting June 1st, 2025, apps must meet the simplified BFS design requirements when submitting for review/renewal to be eligible for the BFS program.

Create dev stores for any plan, including Plus, via the new Dev Dashboard. Access all stores in one interface, free of charge, for accurate testing of production features and restrictions.

Declarative data definitions in TOML streamline metafield management, enable atomic updates, and ensure app-scoped limits, enhancing Shopify app development and migration efficiency.

In the theme editor, block presets now have automatic visual previews in the picker.

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

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

Use the CustomerPrivacy API to interact with customer privacy settings on customer account pages, including the Order status page.

LiquidDoc enhances Liquid snippets and blocks with structured docs, input parameters, and examples. It integrates with theme checks for error prevention, streamlining theme development.

The Skeleton theme offers a minimal, modular Shopify template aligned with best practices for quick developer setup.

The Dev Dashboard offers unified app management, enhanced development stores, and improved app versioning, streamlining workflows and ensuring apps are up-to-date and scalable.

Shopify Functions now support a WebAssembly query API for faster, efficient functions. Deserialize data on-demand and pay only for the fields you use.

Shopify Flow has an improved Send HTTP request action that supports a broader range of integrations with external services by securely storing secrets and returning data to subsequent workflow steps.

Early access: The shopify app dev command now allows you to build and test your complete app code and configuration in an isolated environment, without deploying.

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.

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.

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.

Hydrogen v2025.4.0 updates SFAPI, fixes internationalization and cart issues, improves logout handling, deprecates <VariantSelector />, and refactors ProductItem component.

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.