Developer changelog

API version 2025-04 lets you manage shop privacy settings, including cookie banners, data sale opt-outs, and privacy policy automation.

API version 2025-04 introduces the include_mirrored_exchanges query filter parameter, which provides greater flexibility in managing and viewing exchange data.

API version 2025-04 introduces the ends_at, created_at, and updated_at query filter parameters, which provides greater flexibility in managing and viewing discounts.

Explicit grants for app-owned metafields end on Feb 24, 2025. Use custom namespace for sharing metafields between apps after this date.

Hydrogen v2025.1.1 validated Remix v3_singleFetch future flag, stabilized B2B methods and props and several package version updates.

Adds NonTestOrderLimitReached field to SubscriptionBillingAttemptErrorCode, alerting you when you've exceeded the order limit for a payment processor.

New Liquid filters find, find_index, has, and reject simplify array handling by eliminating verbose loops and complex logic, making your code more concise and declarative

Use the GraphQL Admin API to query the retail location where customers are updating their marketing consent.

As of 2025-04, Product Variant mutations will validate country harmonized system codes against existing inventory item harmonized system codes.

app deploy now instantly deploys Flow template extensions. After a post-deploy review, approved templates appear in the library; unapproved ones receive feedback for changes before redeployment.

Revamped our Discounts GraphQL Admin API docs with more detailed descriptions and real-world examples, based on your user feedback!

The 2025-04 API version for Checkout and Customer Account UI extensions allows reading app owned metafields via appMetafield API. Configure by applying the $app format in the extension toml.

API version 2025-04 adds fees and net fields to the GraphQL and REST Admin APIs for adjustment orders, which are helpful for financial reconciliation in balance transactions

Admin API 2025-01 adds 'event' and 'origin' fields to store credit transactions, enhancing traceability and auditing for better financial reporting and customer service.

RELEVANCE will no longer be included in connection sort options by default as of 2025-04. This will eliminate cases where the option offered no unique behavior.

Hydrogen v2025.1.0 adds Storefront API 2025-01 support, validated Remix v3_lazyRouteDiscovery future flag and several bug fixes. Deprecated features removed for improved performance.

New fields event and origin added to store credit transactions for Customer Account GraphQL API 2025-04.

Catalog APIs now support multiple markets per catalog. Use type: REGION to maintain single market behavior.

Payout statuses "In Transit" and "Scheduled" are now merged as "Scheduled." Update workflows to recognize "Scheduled" for accurate payout info. Change is effective immediately.

Access metaobjects in Liquid using metaobjects.type.handle for standardization. The old shop.metaobjects.type.handle is deprecated but still supported. Transition to the new syntax.

API v2025-04 now supports filtering subscriptionContracts by created_at, updated_at, and status in admin and customer APIs.

Starting February 1, 2025, all apps submitted to the Shopify App Store will be checked for scopes that require Shopify permission for approved use cases.

Apps that have unnecessary scopes, or...

As of 2025-04 partial payments can be recorded on orders using the new orderCreateManualPayment mutation....

The themeCreate mutation now supports an optional role argument.

Updated InventoryItemInput and InventoryItem scopes allow updates with write_products and queries with read_products. Restrictions on inventoryLevel and location queries remain. Applies to all API versions.

Support added for $app namespaces in product queries by metafield which improves query flexibility.

As of Admin API 2025-05, we have introduced new error codes that will be returned from the combinedListingUpdate mutation. These new errors are to provide more clarity when the mutation is called...

Enable continuous authentication by appending customerAccessToken to cart in buyerIdentity. Authenticated checkouts now available for all plans.

As of Feb 18, 2025, all apps must show costs and get buyer consent for paid items in Storefront, Cart, and Checkout. Applies to published and unpublished apps.

The orderCreate mutation now supports OrderCreateLineItemInput.weight to set line item weights.

Version 2025-04: Admin API now includes the return field id in product full sync payload, enhancing data tracking for developers.

The GraphQL Admin API now includes the inventoryItem field in ProductVariantSetInput, effective from API version 2024-10, enhancing product management capabilities.

To ensure that the Built for Shopify status represents the highest quality of app apps will need to meet the following performance, integration and category-specific requirements. These...

OrderTransactions.paymentMethods now includes CARTES_BANCAIRES and BANCONTACT. From API version 2025-04, transactions using these methods will show updated values in responses.

Shopify Functions templates for Rust now exclude cargo-wasi due to Rust 1.84 changes. Shopify CLI 3.73 adds default build optimization.

As of 2025-01, Function APIs validate input query variables. Invalid metafields now trigger InvalidVariableValueError, improving error detection and debugging for developers.

Use the new localizedFields in the Checkout Extensions APIs to apply custom validation for tax fields. The localizationExtensions field in the Admin API has now been renamed to localizedFields.

As of January 20, we added the following updates to POS UI Extensions:

Breaking Changes

• Removed the deprecated ActionItem component. Use a...

Markets APIs update: Use backupRegionUpdate for shop-wide regions, BackupRegionUpdateInput replaces MarketRegionCreateInput. Market.currencySettings is nullable. WebPresence replaces MarketWebPresence.

The 2024-10 GraphQL Admin API update adds collection_id as a filter in the products query, usable with specific filters like created_at, status, and vendor.

We introduced two new fields that allow you to accurately nest component products under the parent product in a grouped view.

Storefront API 2025-01 adds CategoryFilter and TaxonomyMetafieldFilter for filtering products by category ID and taxonomy metafield, enhancing search and collection queries.

The minimumRequirement field in discount APIs is now optional, allowing null values. This change simplifies discount setup for merchants in version 2025-01.

GraphQL Admin API 2025-01 deprecates customer_id for customer, allowing direct customer association or upsert, simplifying order creation by removing the need to fetch customer IDs.

As of 2025-01, we've introduced concatenatedOriginContract to subscriptionLine .

You can now query the origin contract of the lines if you have used the Subscription Billing Cycle APIs to...

Starting from 2025-01, unused PriceListErrorCode values will be removed.

In Storefront API 2025-01, adjustmentPercentage in SellingPlanPercentagePriceAdjustment changes from Int to Float, affecting how percentage price adjustments are handled.

API version 2025-01 deprecates storefrontCustomerAccessTokenCreate. Use Customer Accounts API tokens directly with Storefront API for cart and buyer updates, replacing the deprecated mutation.

As of the 2025-01 Admin GraphQL API, you can now query for delivery promise participants, using...

Starting with the Admin API version 2025-01, we've introduced new error codes for the combinedListingUpdate mutation. These enhancements aim to provide clearer feedback when incorrect data is...