Developer changelog

Webhook GraphQL mutations now support a uri field for all address types, deprecating specific endpoint mutations. webhookSubscriptions query adds uri filtering; callbackUrl is deprecated.

For some countries, cash transactions in POS now round to the nearest denomination. API versions 2024-10 and later now contain fields for order and transaction-level cash rounding adjustments.

Line items can now be split across multiple fulfillment locations, preventing overselling and improving inventory accuracy.

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

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

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.

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

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

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.

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

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

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

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

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

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.

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

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.

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

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

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

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

The themeCreate mutation now supports an optional role argument.

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

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.

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 GraphQL Admin API now includes the inventoryItem field in ProductVariantSetInput, effective from API version 2024-10, enhancing product management capabilities.

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

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

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.

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 2025-01, Function APIs validate input query variables. Invalid metafields now trigger InvalidVariableValueError, improving error detection and debugging for developers.

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

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

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

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

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

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