Developer changelog

You can now pass arbitrary parameters to static blocks.

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

{% stylesheet %} and {% javascript %} tags now work in snippets

Cart AJAX API now supports adding/removing discounts via the discount parameter in /cart/update.js.

Group similar section and block presets using the new category property.

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

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.

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.

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

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 themes must meet new requirements for submitting and updating theme listings, starting May 15, 2025.

To increase the trustworthiness of the Shopify App Store, we’re archiving a significant number of outdated, unhelpful, and untrusted reviews.

Adds BUYER_CANNOT_PURCHASE_FOR_COMPANY_LOCATION error code to CartErrorCode.

Display customer store credit on storefront using the new store_credit_account object via customer.store_credit_account.balance.

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

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.

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.

We’ve added new automated checks to the Shopify App Store review process to help you prepare your app for submission, provide faster feedback, and prevent common errors.

Display a modal after purchase with the new paymentSessionModal mutation.

Developers will continue to enjoy a revshare exemption on the first $1 million USD of lifetime revenue, and a 15% share on amounts above that.

Starting April 29, 2025, payment apps can no longer be embedded in the Shopify admin.