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
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:
- 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
Bulk queries now execute up to 4X fasterRead full post –>Shopify bulk queries are now up to 4X faster for exporting large datasets.
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:
- 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:
- Hydrogen
[Draft] 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:
- 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:
- 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:
- 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:
- 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:
- 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:
- 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:
- 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:
- 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:
- 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/.Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
Expiring offline access tokens required for all public apps as of January 1, 2027Read full post –>Starting Jan 1, 2027, all public apps must use expiring offline access tokens for Admin API calls to enhance security. Migrate from non-expiring tokens to avoid authentication errors.
Tags:
- Webhook
Next Generation Events now available in developer previewRead full post –>Next Generation Events are now available in developer preview. Events improve on traditional webhooks with field-level trigger control, custom GraphQL payloads, and filters.
Tags:
- Admin GraphQL API
- 2026-07
Shipping line field now available on FulfillmentOrderLineItemRead full post –>You can query
on, aiding apps in identifying shipping methods for merged fulfillment orders.Tags:
- Platform
Function run log details are now automatically visible with the right access scopesRead full post –>Function run logs are now viewable in the Dev Dashboard based on your app's access scopes. Ensure your app requests necessary scopes to access these logs without merchant intervention.
Tags:
- Checkout UI
- Customer Accounts
Polaris web components migration guides now available for Checkout and Customer Account UI extensionsRead full post –>New migration guides help upgrade Checkout and Customer Account UI extensions to the latest API version, using Preact, Polaris components, and the global
shopifyobject.Tags:
- API
App Events: See app usage and performance data in your Dev DashboardRead full post –>Send custom and billable app events to the App Events API and see a holistic view of your app’s performance in your Dev Dashboard Logs.
Tags:
- Shopify App Store
Shopify App Pricing: charge for usage, recurring subscriptions, or bothRead full post –>Shopify App Pricing lets you configure usage-based pricing, fixed pricing, or combined plans directly in app submission. Shopify handles your app listing, pick-a-plan page, metering, and invoicing.
Tags:
- Storefront GraphQL API
- 2026-07
NewPRODUCT_UNAVAILABLE_IN_BUYER_LOCATIONwarning code in the Storefront API CartRead full post –>Starting with version 2026-07, Storefront API's Cart emits warnings for products unavailable in buyer's location.
Tags:
- Admin GraphQL API
Target discounts to specific marketsRead full post –>You can now create discounts that are eligible for specific markets, giving you better control over which buyers can access your discounts based on region, B2B company location, or retail location.
Tags:
- Action Required
- Platform
Bots and agents should identify themselves via Web Bot AuthRead full post –>Shopify now applies stricter rate limits to bots and agents that access the Storefront API and Shopify-hosted online store pages. For higher rate limits, bot operators should use Web Bot Auth.
Tags:
- Admin GraphQL API
- Storefront GraphQL API
- 2026-07
Publish and unpublish product variants independently from productRead full post –>is nowPublishableallowing fine-grained control over visibility per channel. Variants default published, channels/feeds that do not use product feed should implement support.Tags:
- Action Required
- Tools
App deployment in CI/CD is now available for all appsRead full post –>App automation tokens enable CI/CD deployment for all apps via the Dev Dashboard, replacing CLI tokens. Use with Shopify CLI for GitHub Workflows. Existing CLI tokens remain valid until expiry.
Tags:
- API
More admin intents now support SettingsRead full post –>Seven new Settings intents added for notifications, payments, gift cards, delivery, and business details. Simplifies merchant navigation via API, enhancing app integration efficiency.
Tags:
- Admin GraphQL API
- 2026-07
Default value ofappliesOnSubscriptionchanged totruefor app discount inputsRead full post –>The
default is nowtruein Admin GraphQL API inputs. No action required.Tags:
- Admin GraphQL API
- 2026-07
Add actor field to subscription contract and billing attempt mutationsRead full post –>A new
actorfield in subscription mutations tracks action initiators (customer, merchant, partner).Tags:
- Admin GraphQL API
Analytics metric targets now available in the GraphQL Admin APIRead full post –>GraphQL Admin API now supports creating, updating, reading, and deleting merchant metric targets, enhancing analytics integration for goal-setting, reporting, and planning apps. Requires specific permissions.
Tags:
- POS Extensions
Minor rounding change for custom line item discounts in POS 11.5Read full post –>POS 11.5 changes fixed-amount discounts to per-unit calculation, affecting
. No action needed for API 2026-04 or earlier; future updates will require per-unit amounts.Tags:
- Tools
Scannable discount codesRead full post –>Shopify now supports QR codes for discount codes, usable in POS and online. Apps can generate these QR codes without changes, enhancing the discount experience for merchants and customers.
Tags:
- Action Required
- API
Storefront Catalog MCP now implements UCPRead full post –>The Storefront Catalog MCP server now implements the Universal Commerce Protocol (UCP) Catalog capability to interact with a store's data.
Tags:
- Admin GraphQL API
- 2026-04
App-owned metaobjects can be used without access scopesRead full post –>App-owned metaobjects now require no access scopes, simplifying developer use. Ensure Admin API version 2026-04+ for this feature. Merchant-owned metaobjects still need specific scopes.
Tags:
- Admin GraphQL API
- 2026-07
Payment method identifier now required for customerPaymentMethodRemoteCreateRead full post –>As of API v2026-07,
requires a payment method ID for Stripe, Authorize.net, and Braintree. Update integrations to include these IDs.