Developer changelog

Added FREE_GIFT_CARD_NOT_ALLOWED to SubscriptionBillingAttemptErrorCode enum, preventing subscriptions from including gift cards sold at a zero price.

As of version 2025-07 of the GraphQL Storefront API, Cart now provides warnings for non-applicable discount codes.

You can now pass arbitrary parameters to static blocks.

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

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

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.

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

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

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

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.

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.

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

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

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

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

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

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.

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.

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.

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 Order Edit API allows you to edit line items containing selling plans before an order ships.

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

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

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.

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

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

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

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

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.

New query parameters name and confirmation_number added to the orders connection in the GraphQL Customer Account API, enabling more precise order filtering.

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.

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

API version 2025-07 deprecates the draftOrderCreateMerchantCheckout mutation.

event.data.checkout.subtotalPrice.amount on the new /thank-you page now sums line item prices after product and order discounts, aligning with the old /thank_you page.

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.