Developer changelog
Subscribe to the changelog to stay up to date on recent changes to Shopify’s APIs and other developer products, as well as preview upcoming features and beta releases.
Tags:
- Admin GraphQL API
- Customer Accounts
- 2026-07
Draft order deposit fields are now available in the GraphQL Admin API and Customer Account APIRead full post –>New 2026-07 APIs add draft order deposits: apps can set partial payments via Admin GraphQL, customers see deposit details via Customer Account API. Shopify Plus only.
Tags:
- Action Required
- Admin GraphQL API
- 2026-07
Deprecation of cumulative marketing engagementsRead full post –>The
argument inis deprecated, defaulting tofalse. Update integrations to send non-cumulative engagements. Migration is available anytime.Tags:
- Admin GraphQL API
- 2026-07
NewlineItemfield on theGiftCardobjectRead full post –>The
object in the GraphQL Admin API now includes afield, linking gift cards to their originating order, ornullif issued manually.Tags:
- Customer Account API
- 2026-07
Discount application information now available for draft orders on the Customer Account APIRead full post –>New GraphQL Customer Account API fields expose draft order discounts and per-line-item allocations, enabling precise discount querying and analysis for draft orders.
Tags:
- Customer Account API
- 2026-07
discountedUnitPriceonDraftOrderLineItemCustomer Account API deprecationRead full post –>discountedUnitPrice on DraftOrderLineItem is now deprecated. Use approximateDiscountedUnitPrice instead and update queries for per-unit discounts.
Tags:
- Admin GraphQL API
- 2026-07
BusinessEntitynow exposeslegalEntityIdin the GraphQL Admin APIRead full post –>In API v2026-07,
in Admin API now includes, a stable ID for consistent legal entity identification across shops and markets, aiding partner integrations.Tags:
- Action Required
- Admin GraphQL API
- 2026-07
Merchant-owned delivery profile APIs are deprecated for market-driven shippingRead full post –>Merchant-owned shipping moves from delivery profiles to Markets. Legacy delivery profile GraphQL APIs become stale for these shops; apps must migrate to market-driven shipping APIs.
Tags:
- Admin GraphQL API
- 2026-07
Market-driven shipping Admin APIRead full post –>The new Admin GraphQL API lets you configure market-specific shipping rates, supporting multiple rate types, conditions, and real-time carrier rate fetching.
Tags:
- Hydrogen
Hydrogen now deploys to VercelRead full post –>The Next.js starter template in the Hydrogen developer preview now has a Deploy button that ships it to Vercel.
Tags:
- Admin Extensions
- Admin GraphQL API
- Storefront GraphQL API
- 2026-07
Configure order attribution for sales channel appsRead full post –>New 2026-07: sales channel apps can define granular order attribution, pass handles via orders/carts, manage via Admin GraphQL, and read results with deprecated Order.channelInformation.
Tags:
- Admin GraphQL API
- 2026-07
Payment mandates now expose an id fieldRead full post –>In API version 2026-07 and later, the
object includes a newidfield.is returned by themandatesconnection on. Its...Tags:
- Admin GraphQL API
- Admin REST API
- 2026-10
Carrier services will no longer be automatically added to the default shipping profileRead full post –>Starting in Admin API 2026-10, GraphQL and REST carrier service creation won’t auto-add rates to the General shipping profile.
Tags:
- Action Required
- API
Storefront MCP cart tools are being deprecated in favour of UCP Cart MCPRead full post –>Storefront MCP get_cart/update_cart deprecated. Migrate to UCP Cart MCP.
Tags:
- Action Required
- Admin GraphQL API
- 2026-10
DraftOrderDiscountNotAppliedWarning.priceRuleremoved in GraphQL Admin API 2026-10Read full post –>2026-10 Admin API removes DraftOrderDiscountNotAppliedWarning.priceRule and PriceRule types. Update queries to use discountTitle and discountCode instead.
Tags:
- Action Required
- Admin GraphQL API
- 2026-10
Removal of ITEM_NOT_STOCKED_AT_LOCATION errorRead full post –>ITEM_NOT_STOCKED_AT_LOCATION error removed from inventory APIs in 2026-10. Apps can drop handling for this obsolete error as inventory is adjustable at any location.
Tags:
- Tools
Flow action extensions now support relative paths for endpoint URLsRead full post –>Flow action URLs now support relative paths, enabling you to more easily use tunnels during local development.
Tags:
- Admin Extensions
- 2026-04
New purchaseType and recurringCycleLimit fields in the discounts API for discount UI extensionsRead full post –>App discount UI extensions can now configure purchaseType and recurringCycleLimit through the discounts plugin to control subscription behavior.
Tags:
- Tools
- Admin Extensions
- App Bridge
Apps can now open Shopify’s file picker with the Intents APIRead full post –>Use the Intents API with
to let merchants choose files from their Shopify file library.Tags:
- Admin GraphQL API
- 2026-07
Admin GraphQL API now supports app-owned delivery profiles that cover all shippable itemsRead full post –>New Admin GraphQL 2026-07 field coversAllItems for app-owned shipping delivery profiles lets authorized apps apply rates to all shippable items without per-product assignment
Tags:
- Admin GraphQL API
- 2026-07
Define and set metafields on inventory transfers in the GraphQL Admin APIRead full post –>Admin GraphQL API 2026-07 allows defining and setting metafields directly in inventory transfers, streamlining custom data integration without separate metafieldsSet calls.
Tags:
- Admin GraphQL API
Purchase-type filtering now enforced for app discountsRead full post –>The appliesOnSubscription and appliesOnOneTimePurchase fields on app discounts are now enforced at checkout. Existing discounts are unaffected.
Tags:
- Hydrogen
Hydrogen developer previewRead full post –>The next version of Hydrogen allows you to use Shopify's commerce primitives in any JavaScript framework. Now available as a developer preview.
Tags:
- Admin GraphQL API
- 2026-07
Create channel markets with the GraphQL Admin APIRead full post –>API 2026-07: GraphQL Admin adds channel markets. Create, update, and query markets per sales channel for channel-specific availability, pricing, and currencies.
Tags:
- Action Required
- Admin GraphQL API
- Customer Account API
- Webhook
- 2026-07
WhatsApp marketing consent now available in the Admin API and Customer Account APIRead full post –>New APIs let you read and update WhatsApp marketing consent on a customer’s default phone via customerWhatsAppMarketingConsentUpdate and the CustomerPhoneNumber consent field
Tags:
- Shopify App Store
New App Store requirements for Sidekick app extensionsRead full post –>New Shopify rules for Sidekick extensions: must match core app functionality and App Store listing, and cannot show promotions, ads, cross-sell content, or review requests.
Tags:
- Admin GraphQL API
Bulk queries now execute up to 4X fasterRead full post –>Shopify bulk queries are now up to 4X faster for exporting large datasets.
Tags:
- Platform
Sidekick app extensions available todayRead full post –>All app developers can now build Sidekick app extensions. These extensions allow your app to integrate with Sidekick, giving Sidekick the ability to access data or take action within your apps.
Tags:
- Themes
Color palettes in ThemesRead full post –>A new
setting type lets themes define a flat list of colors that merchants edit directly, replacing color schemes as the recommended approach.Tags:
- Action Required
- Built for Shopify
Built for Shopify requirements for Returns and exchanges apps and Subscription apps (effective December 1, 2026)Read full post –>Apps must use the Customer Account API to authenticate buyers by December 1, 2026, to maintain Built for Shopify status, ensuring secure, unified sign-in across storefronts and apps.
Tags:
- Tools
Monitor admin web vitals in the Dev DashboardRead full post –>Check your app's LCP, INP, and CLS scores in one place, with the same data that determines your Built for Shopify status.
Tags:
- Themes
Standard storefront events and actionsRead full post –>Themes can now emit standardized events and expose actions that let apps and agents interact with the storefront reliably across all themes.
Tags:
- Admin GraphQL API
- 2026-07
Buy Shipping Labels with the GraphQL Admin APIRead full post –>New Admin GraphQL shippingLabelPurchase mutation lets apps buy Shopify Shipping labels asynchronously for fulfillment orders
Tags:
- Action Required
- Admin GraphQL API
- Functions
- 2026-07
New Collection model and APIs now availableRead full post –>2026-07 adds a new Collection model with multiple product group sources, shareable app-owned sources, and variant-level collection membership; migrate from ruleSet and legacy collection input.
Tags:
- Action Required
- Platform
Metafields now require a definition to be accessed through the Customer Account APIRead full post –>To be accessible through the Customer Account API, metafields stored on the app resource must have a metafield definition with customer accounts permissions.
Tags:
- API
- 2026-07
New appSubscriptionCancel mutation in the Partner APIRead full post –>New Partner API 2026-07 appSubscriptionCancel mutation lets partners cancel owned public app subscriptions, schedule end-of-cycle cancels, and request prorated credits.
Tags:
- Functions
- 2026-07
Shop User Metafields in Shopify FunctionsRead full post –>Shop User metafields are now readable during checkout via Shopify Functions, enabling partners to access buyer-specific data and customize checkout experiences.
Tags:
- Storefront GraphQL API
- 2026-07
Read a cart line'sviewKeyfrom theCartLinetypeRead full post –>The CartLine type now returns viewKey, so you can correlate returned lines with the view_key sent to cartLinesUpdate and cartLinesRemove.
Tags:
- Action Required
- Tools
Shopify AI Toolkit for upgrading extensions to Polaris web componentsRead full post –>Use the Shopify AI Toolkit and enhanced dev docs to speed up your checkout and customer account UI extension upgrade to Polaris web components. Complete the upgrade by October 1, 2026.
Tags:
- Admin GraphQL API
- 2026-07
Streamlined Metaobject APIRead full post –>New Metaobject values property enables simplified reads/writes with automatic conversion to/from JSON objects
Tags:
- Customer Account API
- Hydrogen
- Storefront GraphQL API
Headless checkout SSO is now documented with sso=silentRead full post –>Headless checkout docs now use
sso=silentfor silent SSO, replacing. Existing URLs remain valid. Update impacts terminology, not functionality.Tags:
- Admin GraphQL API
- 2026-07
GiftCardCashOutTransactionis now resolvable fromGiftCardTransactionRead full post –>In GraphQL Admin API v2026-07,
is added to distinguish cash-out adjustments from debits. Queryusing__typenameto identify them.Tags:
- Admin GraphQL API
- 2026-07
Local currency support gift cards now available in the GraphQL Admin APIRead full post –>API v2026-07 adds local currency gift cards via GraphQL Admin API. Use
for creation, set, manage cross-currency redemption, and query settings.Tags:
- Admin GraphQL API
- 2026-07
Inventory transfer webhooks include origin and destination location IDs, and mutation documentation clarifiedRead full post –>New inventory transfer webhooks include origin and destination fields. Documentation for inventoryTransferSetItems and inventoryTransferRemoveItems is clarified. Error messages are more descriptive.
Tags:
- Shopify App Store
App quality checks now managed in Partner DashboardRead full post –>Track and resolve app quality check feedback on published apps in the Partner Dashboard.
Tags:
- Storefront GraphQL API
- 2026-07
Identify cart lines byview_keyincartLinesUpdateandcartLinesRemoveRead full post –>cartLinesUpdate and cartLinesRemove now accept view_key to identify cart lines
Tags:
- Themes
Customize /llms.txt, /llms-full.txt and /agents.mdRead full post –>Customize content for
/agents.md,/llms.txt, and/llms-full.txtby adding specific templates in Themes. Defaults toagents.mdif no template is set.Tags:
- Admin Extensions
- 2026-07
Build App Home as a UI extensionRead full post –>Create App Home landing pages using Preact-based admin UI extensions with
admin.app.home.render. Bundles with admin UI, no web server needed. Available for custom apps from API version 2026-07.Tags:
- Tools
Shopify CLI 4.0: SemVer, auto-updates, removing deprecated flags and commandsRead full post –>Shopify CLI 4.0 introduces semantic versioning, automatic updates, and removes the
--forceflag. Deprecated commands are removed, enhancing control and clarity for developers.Tags:
- Platform
Feature preview: Customer account improvementsRead full post –>Customer accounts are getting design updates including a new single-column layout, improved navigation, and more visible UI extensions. Test your customer account UI extensions in the updated design.
Tags:
- Shop Minis
Shop Minis March April 2026 updateRead full post –>Shop Minis update: Optional consent with new hooks, intents for contextual launches, async storage limits,
for stock checks, and deprecation of/.