Developer changelog

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.

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

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.

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

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.

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

Starting with the Admin API version 2025-01, we have added the sales_line_item_group_id field to the orders webhook. This field allows you to determine if a specific line_item is part of a...

Starting January 6, 2025, all new apps submitted to the Shopify App Store must use the [new GraphQL Product...

As of Admin API 2024-10, we have introduced a concept of tax_exempt in a CompanyLocationTaxSettings object for a CompanyLocations. This is a generic tax exemption flag for company locations outs

In Admin GraphQL API 2025-01, handle in product inputs must be unique, preventing duplicates in product creation/updates. Existing behavior unchanged if handle is omitted.

As of Admin API 2025-04, we have introduced a new field requiresShippingMethod on the...

As of the 2025-01 version of the GraphQL Admin API, you can now use a limit of up to 2000 variants when running a query on a single product, such as product or productByHandle. This...

Starting in API version 2025-01, RELEVANCE will be removed as a valid value from...

Up until now, merchants had the ability to link their options to category metafields, allowing them to use these option values across similar products. This release expands that functionality to...

As of Admin API 2025-01, we have officially introduced a new fulfillment event status called delayed.

As of 2025-01, the ReverseFulfillmentOrder.order field is nullable if the client lacks read_all_orders scope and the order is over 60 days old or missing, avoiding graphql errors.

As of Payments Apps API version 2025-01 release, the paymentDetails field will be addded to verificationSessionResolve mutation. Payment providers can now send payment details like Card...

BXGY discounts now support subscriptions if X is a subscription and Y is a one-time or free item. Use GraphQL mutations to create/update discounts, specifying item types with input fields.

Version 2025-01 adds 3DS challenge support for vaulting payments via VerificationSessionRedirect mutation. Update to handle new arguments and deprecated states.

Admin API 2025-01 restricts fulfillment hold access via node queries based on app scopes. Ensure correct scopes to avoid null results when fetching holds.

API v2025-01 deprecates buyerIdentity.deliveryAddressPreferences, replacing it with cart.delivery.addresses. Manage addresses using new mutations.

As of API version 2025-01, we're deprecating the tax and duty fields in Storefront API Cart. Tax and Duties are...

The 2025-01 API allows multiple holds per fulfillment order, requires unique handles, and introduces new webhooks. REST API remains limited to single holds.

As of 2025-01, customer webhooks updated: new customers/purchasing_summary added, tags and consent fields replaced, and some fields moved to the new webhook.

When creating or updating a metafield definition's access the admin field is now optional. When admin is not explicitly set, it will default the same way it is when the entire access field...

New feature: Specify revocation reasons for customer payment methods, improving management without affecting existing partners.

The CustomerPaymentMethodRemoteCreditCardCreate mutation is deprecated and unsupported from API version 2025-01. Update your integrations accordingly.

Review updated Partner Program and API Terms effective Dec 30, 2024. Theme Revenue Share changes Jan 1, 2025. Ensure compliance to support app growth and security.

The 2025-07 version of the GraphQL Admin API deprecates SubscriptionMailingAddress. Use MailingAddress for future implementations.