← All APIs

What changed in the Shopify API

BreakWatch diffs the Shopify changelog every day and classifies each change as breaking, additive, or docs-only. 4 breaking changes have been detected so far.

  • docShopify

    Exclusive > timestamp filters exclude the full second

    Exclusive > timestamp filters exclude the full second
    Shopify dev changelog ↗
  • docShopify

    Act now to secure your app: We're asking every app dev to act this week. We have new tools to help, including AI security scans, expiring tokens, and better log filtering. Read on to learn how.

    Securing your app, together
    Act now to secure your app: We're asking every app dev to act this week. We have new tools to help, including AI security scans, expiring tokens, and better log filtering. Read on to learn how.
     Metaobject analytics queryable capability available in the Admin API
    Shopify dev changelog ↗
  • docShopify

    Manage packed product dimensions with the GraphQL Admin API

    Hydrogen developer preview update: October 8, 2026
    Hydrogen developer preview update: October 2, 2026
    Manage packed product dimensions with the GraphQL Admin API
    Hydrogen developer preview update: September 11, 2026
    Shopify dev changelog ↗
  • additiveShopify

    Checkout MCP and Cart MCP now support UCP buyer consent

    Checkout MCP and Cart MCP now support UCP buyer consent
    Shopify dev changelog ↗
  • docShopify

    Check your app for security vulnerabilities with `shopify app security check`. Run it before you submit an app, and on every release, to catch problems in your own code and get remediation guidance.

    Build with confidence: Shopify AI Toolkit's security check 
    Check your app for security vulnerabilities with `shopify app security check`. Run it before you submit an app, and on every release, to catch problems in your own code and get remediation guidance.
    Shopify dev changelog ↗
  • breakingShopify

    Cart updates that result in no changes to the cart no longer trigger carts/update webhooks

    Add shopping and Shop Pay checkout to any agent with Shop MCP 
    Cart updates that result in no changes to the cart no longer trigger carts/update webhooks
    Shopify dev changelog ↗
  • docShopify

    Identify the published version running in a POS extension

    Detect when a POS extension screen finishes navigating
    Identify the published version running in a POS extension
    Shopify dev changelog ↗
  • docShopify

    Global Catalog REST API stops serving traffic on November 2, 2026

    Global Catalog REST API stops serving traffic on November 2, 2026
    Catalog API now returns compare-at prices as 
     field for metafield declarations in Checkout and Customer Account UI extensions, required in 2027-01
    Shopify dev changelog ↗
  • docShopify

    POS UI extensions now return percentage values for percentage discounts

    Cart mutations reject unconfirmed writes in POS UI extensions 2026-10
    POS UI extensions now return percentage values for percentage discounts
    Per-customer request limit for the Customer Account API
    Downgrade app access scopes from write to read
    Shopify dev changelog ↗
  • docShopify

    Shopify is releasing fulfillment upgrades that help merchants sell across more locations, delivery methods, and markets with less friction at checkout.

    What's new in Polaris 2.0.0-rc.1
    New Shop Campaigns metrics and dimensions in ShopifyQL API version 2026-10
    New tax fields for return shipping fees in the GraphQL Admin API
    Meet the 2026 Shopify Build Award winners
    Meet the 2026 Shopify Build Award winners across apps, storefronts, merchant impact, and community.
    Sign in with Shop opens to storefront apps
    Sign in with Shop is now a drop-in component any storefront app can integrate — wishlists, back-in-stock, loyalty, and more.
    The next generation of Shopify fulfillment is coming
    Shopify is releasing fulfillment upgrades that help merchants sell across more locations, delivery methods, and markets with less friction at checkout.
    Shopify dev changelog ↗
  • additiveShopify

    Return policy profiles are now available in the GraphQL Admin API

    Return policy profiles are now available in the GraphQL Admin API
    New APIs for buyer-requested order edits
    Shopify dev changelog ↗
  • breakingShopify

    Covers order tax recalculation, metafield filter errors, and removed checkout fields.

    More control over commerce updates with Next Gen Events
    Fewer deliveries, richer payloads, no follow-up queries: Events is a declarative replacement for classic webhooks, now generally available across 18 topics.
    Rollouts queries and webhooks in the Admin GraphQL API
    Discounts can now be included in Rollouts
    Orders webhooks now include selling_plan_id on line items
    New fiscalDeviceIdentifier field on PointOfSaleDevice
     collection condition removed in API version 2027-01
    Added parseWarnings to ShopifyqlQueryResponse
     mutation now returns a structured 
    SMS marketing consent now available on the CustomerPhoneNumber object
    Tax webhook summary and calculation requests now use Global IDs
    New SubscriptionContractCalculation API for subscription management 
     Inventory shipment webhooks include inventory transfer IDs
    Updated function syntax on the segment query language
    Covers order tax recalculation, metafield filter errors, and removed checkout fields.
    Shopify dev changelog ↗
  • additiveShopify

    Shopify Flow: Flow Trigger Lifecycle Callback extensions now support relative url paths

    Use app intents for your discount app
    Shopify Flow: Flow Trigger Lifecycle Callback extensions now support relative url paths
    Shopify dev changelog ↗
  • docShopify

    More resilient token exchanges when migrating tokens without a user session

    More resilient token exchanges when migrating tokens without a user session
    Manage packed product dimensions with the Admin GraphQL API
    Move existing subscriptions to Shopify App Pricing
    Shopify dev changelog ↗
  • docShopify

    Sidekick can now invoke app intents without tools

    Sidekick can now invoke app intents without tools
    WebMCP support for checkout
    Shopify dev changelog ↗
  • docShopify

    One home for your apps and the stores you work in: Designed to make your everyday easier.

    The new Dev Dashboard: your command center for building
    One home for your apps and the stores you work in: Designed to make your everyday easier.
    AI Toolkit skills have been consolidated to 
    Shopify Payments Balance Transaction GraphQL type supports currency conversion type
    Polaris 2.0 release candidate
     Query SP Fee Details with the GraphQL Admin API
    Shopify dev changelog ↗
  • docShopify

    Setting includeRestOfWorld to true returns an error in API version 2027-01

    Setting includeRestOfWorld to true returns an error in API version 2027-01
    Shopify dev changelog ↗
  • docShopify

    Events subscription query complexity limit is changing to 100 points

    Events subscription query complexity limit is changing to 100 points
    Polaris CDN 1.1 is now stable
    Removing marketCurrencySettingsUpdate mutation
    Shopify dev changelog ↗
  • docShopify

    Unlimited private plans and target stores in Shopify App Pricing

    Unlimited private plans and target stores in Shopify App Pricing
    New translatable boolean field for Metafield GraphQL Object
    Shopify dev changelog ↗
  • breakingShopify

    query is removed in API version 2027-01

     query is removed in API version 2027-01
    Shopify dev changelog ↗
  • breakingShopify

    Removed session.currentSession.staffMemberId from POS UI Extensions (2026-10)

    Request a bundle size exception for existing UI extensions
    Adding a canceled receive action to the inventory shipments API
    Removed session.currentSession.staffMemberId from POS UI Extensions (2026-10)
    Query market hierarchies with the GraphQL Admin API
    New Pricing audit trail for contextual product variant prices
    Shopify dev changelog ↗
  • docShopify

    Updates to Events payloads and subscription configuration

    Updates to Events payloads and subscription configuration
    Shopify dev changelog ↗
  • docShopify

    Delivery options in Shopify Functions input now expose their metafields

    Filter Catalog search results by media type
    Dynamic complexity cost for 
    Prepare your app for the Shopify admin's new look
    family_name is optional for B2B orders in Payments Apps API requests
    Delivery options in Shopify Functions input now expose their metafields
    Shopify dev changelog ↗
  • docShopify

    New paymentInstrumentSendAddEmail mutation emails customers a link to add a payment method for a subscription, order, or draft order

    New paymentInstrumentSendAddEmail mutation emails customers a link to add a payment method for a subscription, order, or draft order
    Shopify dev changelog ↗
  • docShopify

    Discounts Allocator Function API developer preview has ended

    Discounts Allocator Function API developer preview has ended
    Shopify dev changelog ↗
  • docShopify

    Adds richer merchandising and returns data, expanded extension capabilities, inventory safety updates, and metaobject changes.

    Create and delete dev stores in Shopify CLI
    Adds richer merchandising and returns data, expanded extension capabilities, inventory safety updates, and metaobject changes.
    Shopify dev changelog ↗

Depend on Shopify?

Get alerted the moment a breaking change ships — plus every other API your product relies on. Free to start, no card.

Monitor Shopify free