2027-01: Release notes
The 2027-01 release focuses on discount, collection, market, metaobject, inventory, and tax app changes.
Several changes in this version require code updates, especially around automatic discount queries, collection metafield conditions, market currency settings, and tax app payloads. Review and adjust affected integrations before adopting 2027-01.
2027-01 is available as a release candidate for development testing until January 1, 2027, when it becomes stable:
- 2027-01RCStableUnsupported
Learn more about API versioning
| Stable version | Release date | Accessible until | Status |
|---|---|---|---|
| 2027-01 | January 1, 2027 | January 16, 2028 15:00 UTC | Release candidate |
Anchor to GraphQL Admin APIGraph QL Admin API
GraphQL Admin API changes remove deprecated discount, collection, and market currency APIs. Changes also add packed product dimensions and access scope downgrades.
Anchor to AppsApps
Apps can downgrade optional write access scopes to read access.
Apps that use Shopify-managed installation can call the new appDowngradeAccessScopes mutation to replace optional write scopes with their matching read scopes, such as write_products with read_products. Required scopes can't be downgraded, and no scopes change if any requested scope fails validation.
Anchor to CustomersCustomers
Apps can unlink customers from third-party identity providers.
The new identityProviderSubjectDelete mutation unlinks a customer from a third-party identity provider and signs them out of all existing sessions. Get subject IDs from Customer.identityProviderSubjects, and request the write_customers access scope to call it.
Anchor to Discounts and marketingDiscounts and marketing
Apps that read automatic discounts need to move to discountNodes.
The deprecated automaticDiscounts query is removed, along with the DiscountAutomaticConnection and DiscountAutomaticEdge types. Query discountNodes with a method:automatic filter instead, rather than the also-deprecated automaticDiscountNodes query.
Anchor to InventoryInventory
Inventory items can store packed dimensions for automatic package selection.
InventoryItemMeasurement.packedDimensions and InventoryItemMeasurementInput.packedDimensions let apps read and write an inventory item's packed length, width, height, and unit. Shopify uses these measurements to select the smallest saved package that fits eligible multi-item orders.
Anchor to MarketsMarkets
Apps that still call the removed market currency mutation need to use marketCreate and marketUpdate.
The marketCurrencySettingsUpdate mutation is removed, along with MarketCurrencySettingsUpdatePayload, MarketCurrencySettingsUserError, and MarketCurrencySettingsUserErrorCode. The mutation already fails on every call, so set currency settings with marketCreate and marketUpdate instead.
Anchor to MetaobjectsMetaobjects
Metaobject definitions drop obsolete admin access values.
The obsolete PRIVATE and PUBLIC_READ values are removed from the MetaobjectAdminAccess enum. The API never returns them, so remove references to these values from your queries, mutations, and generated types.
MetaobjectCapabilities.analyticsQueryable reports whether a metaobject definition is eligible for analytics queries and whether the capability is enabled. Set it with MetaobjectCapabilityCreateInput or MetaobjectCapabilityUpdateInput, and handle the CAPABILITY_NOT_ELIGIBLE user error.
Anchor to OrdersOrders
Draft orders can carry subscription selling plans, and orderCreate line items can identify variants by custom ID.
DraftOrderLineItemInput.sellingPlanId applies a recurring or prepaid selling plan to a product variant line item in draftOrderCreate, draftOrderUpdate, and draftOrderCalculate, and sellingPlanApplication reads it back. draftOrderComplete doesn't support these drafts yet, so send them to checkout with draftOrderInvoiceSend.
OrderCreateLineItemInput.variantIdentifier identifies a product variant by its id or by a customId stored in an id metafield, such as a listing ID from another system. Setting it together with variantId or productId returns an INVALID user error.
Anchor to Products and collectionsProducts and collections
Collection integrations that use integer metafield conditions need to move to metafieldInt.
The metafieldInteger collection source condition inputs and the CollectionSourceInclusionConditionMetafieldInteger types are removed. Use metafieldInt and CollectionSourceInclusionConditionMetafieldInt instead, and send integer metafield condition value fields as strings.
Anchor to Shipping and fulfillmentShipping and fulfillment
Fulfillment order destinations include a province code.
FulfillmentOrderDestination.provinceCode returns the destination's province or state code, such as ON for Ontario, so apps don't need to map the province name. It returns null when the destination has no province or the province isn't recognized.
Anchor to Store creditStore credit
Store credit transactions can carry merchant-only notes.
StoreCreditAccountCreditInput and StoreCreditAccountDebitInput accept an optional note of up to 5,000 characters, and StoreCreditAccountTransaction.note returns it. Notes are visible to merchants only and can't be edited after the transaction is created.
Anchor to TaxesTaxes
Apps that write market, publishing, or custom line item tax settings need to handle Shopify Tax managed mode.
For stores that use Shopify Tax managed mode, marketCreate and marketUpdate reject conflicting currency and tax-display settings, and products on dependent channels such as Online Store must also be published to Shop. The custom line item taxable input is deprecated in favor of productCategoryId.
Anchor to Events & webhooksEvents & webhooks
Tax apps need to handle Global IDs in tax calculation requests and tax summary webhooks.
Third-party tax apps now receive Global IDs instead of numeric IDs for customers, companies, products, variants, line items, and other entities in tax calculation requests and tax summary webhook payloads. Update your parsing to handle the GID format.
Oct 1, 2026Anchor to Payments Apps APIPayments Apps API
Payments apps can accept missing CVV for cards from a vault that Shopify trusts.
Credit card payment and verification requests can include the optional payment_method.data.trusted_vault_origin Boolean. When it's true, don't reject the request for a missing CVV alone, and keep your existing CVV rules when it's false or absent. Shopify must enable the field for your app.
Anchor to PolarisPolaris
Polaris updates let checkout and customer account UI extensions send App Events, and change what the currententrychange event reports in customer account full-page extensions.
Anchor to Checkout and customer accountsCheckout and customer accounts
Checkout and customer account UI extensions can send App Events without an app backend. Customer account full-page extensions that read the new page from event.from need to update their navigation handlers.
Checkout and customer account UI extensions can call shopify.appEvents.emit() to send App Events without network access. Events are sent only after the buyer allows analytics processing, appear in your Dev Dashboard logs, and aren't processed for billing.
In customer account full-page extensions, the currententrychange event's event.from returns the page the customer navigated away from instead of the new page. Update handlers that read the new page from event.from to read shopify.navigation.currentEntry instead.
Anchor to REST Admin APIREST Admin API
Apps that set a gift card's line item through the REST Admin API need to stop sending it.
The Gift Card resource's line_item_id property is read-only, and Shopify ignores it in create and update requests. Remove line_item_id from those requests before you upgrade, and keep reading it from responses if you need the existing association.
Anchor to Storefront APIStorefront API
Apps and custom storefronts that read market metafields need to check how they match key case.
Market.metafields matches each requested key in any case, as Market.metafield already does. Review queries that request a key in a different case from the stored key, or that read a key stored in different cases across the buyer's markets.