100
Urgent
Shopify Developer Changelog
Official
Local currency support gift cards now available in the GraphQL Admin API
Starting in API version 2026-07 , the GraphQL Admin API supports local currency gift cards. You can create gift card products that are issued in a specific currency, and control whether buyers can redeem those gift cards across currencies. If your app creates gift cards directly, migrate from the deprecated initialValue field to initialAmount . What changed Use the new giftCardProductSet mutation to create and update
Why it matters: This can create operational risk or a time-sensitive decision for Shopify sellers, agencies, or app teams.
Action: Assign an owner, check whether the store or app stack is affected, and decide whether a migration or audit is needed.
100
Opportunity
Shopify Developer Changelog
Official
Tax summary webhook and calculation requests now include customer and company metafields
As of API version 2026-04, tax calculation requests for tax partner apps now include buyer metafields. These fields provide custom data associated with customers (for D2C orders) and companies (for B2B orders) that may affect tax calculations. This enhancement allows tax partners to access merchant-defined buyer attributes for more accurate tax determination and compliance reporting. What's new The tax calculation re
Why it matters: This can create operational risk or a time-sensitive decision for Shopify sellers, agencies, or app teams.
Action: Assign an owner, check whether the store or app stack is affected, and decide whether a migration or audit is needed.
94
Urgent
Shopify Developer Changelog
Official
Checkout And Accounts Configuration API for unified branding across checkout, customer accounts, and sign-in
New Checkout And Accounts Configuration API (2026-04) replaces deprecated Checkout Profile and Checkout Branding APIs for unified branding across checkout, customer accounts, and sign-in. Plus-only.
Why it matters: Agencies and app developers building checkout/accounts customizations must migrate off two deprecated APIs onto a unified replacement; Plus merchants get consolidated branding control across all buyer-facing surfaces.
Action: Migrate Checkout Profile and Checkout Branding API usage to the new Checkout And Accounts Configuration API; audit extensions touching checkout, sign-in, or customer accounts.
94
Urgent
Shopify Developer Changelog
Official
Shopify Scripts will be deprecated on June 30, 2026
Shopify Scripts will be deprecated June 30, 2026; Shopify Functions is gaining expanded discount, shipping, and payments capabilities to replace Scripts. A migration report is recommended.
Why it matters: Hard deadline forcing every merchant running Scripts to a migration project; significant revenue risk if the migration window is missed.
Action: Run the Shopify Scripts customizations report for any client using Scripts; build a Functions migration plan with clear deprecation-deadline milestones before June 30, 2026.
92
Urgent
Shopify Developer Changelog
Official
Expiring offline access tokens required for all public apps as of January 1, 2027
Starting January 1, 2027, all public apps must use expiring offline access tokens for Admin API calls; non-expiring tokens will return authentication errors.
Why it matters: Hard deadline affecting every public app; teams must complete token migration before 2027-01-01 to avoid authentication outages for merchants.
Action: Build a migration plan for switching public apps to expiring offline tokens, including refresh handling, and complete it before 2027-01-01.
92
Evaluate
Shopify Developer Changelog
Official
Replacing or deleting a Shopify-hosted file no longer purges its CDN URL
As of April 7, 2026, replacing/deleting a Shopify-hosted file no longer proactively purges its cdn.shopify.com URL; cached content serves until TTL expires. Merchants/developers must build their own cache-busting to avoid stale assets.
Why it matters: This is a silent behavior change with real customer-facing risk: stale theme assets, app assets, or product images can persist for an unknown TTL window. Theme devs and app builders relying on instant cache invalidation need to revise workflows immediately (versioned filenames, cache-busting query params, or waiting TTL).
Action: Audit theme assets and any app-served files that get replaced/upated; implement filename versioning or cache-busting query params for assets that must refresh instantly. Test storefront pages after file deletes to confirm stale content isn't being served.
92
Opportunity
Shopify Developer Changelog
Official
Next Generation Events now available in developer preview
Next Generation Events are in developer preview, offering field-level triggers that pre-qualify webhook deliveries before they reach your endpoint.
Why it matters: Reduces webhook noise and processing costs by letting apps subscribe to specific field changes (e.g., only price updates on variants), improving reliability for apps that currently over-receive events.
Action: Prototype against the new event subscriptions in a dev store; map your current webhook topics to the field-scoped equivalents to cut payload volume.
92
Opportunity
Shopify Developer Changelog
Official
Create unpaid orders from subscription billing attempts
Shopify's API 2026-04 release adds a paymentProcessingPolicy field to subscriptionBillingAttemptCreate, letting apps create unpaid orders when a subscription billing attempt fails due to an invalid payment method instead of blocking order creation.
Why it matters: This gives subscription apps and merchants explicit control over dunning flow: failed charges can now produce an unpaid order that enters the normal order workflow (fulfillment holds, manual payment capture, recovery attempts) rather than being lost as a silent failure. It directly impacts churn and involuntary churn recovery strategies.
Action: Review existing subscription billing attempt flows in your app or custom integration; plan migration to API 2026-04 and add support for the new paymentProcessingPolicy values (e.g., create_unpaid_order). Coordinate with finance/ops on how unpaid subscription orders will be tracked and reconciled.
92
Urgent
Shopify Changelog
Official
Shopify Scripts deprecation creates an action deadline for Plus merchants
Shopify Scripts deprecation requires Plus teams to review legacy discount, shipping, and payment customizations before execution ends.
Why it matters: This is not just a developer update. It can affect checkout behavior, promotion logic, agency retainers, and migration planning.
Action: Audit active Scripts, map each one to Shopify Functions or an app workflow, and assign an owner for migration.
90
Urgent
Shopify Developer Changelog
Official
Merchant-owned delivery profile APIs are deprecated for market-driven shipping
Merchant-owned delivery profile fields and mutations in the Admin GraphQL API are deprecated when a shop uses market-driven shipping; reads may return stale snapshots and writes may be ignored.
Why it matters: Apps that read or write merchant shipping via delivery profiles risk returning or applying wrong shipping configurations as merchants opt into market-driven shipping. This is a behavior-level deprecation, not just a naming change.
Action: Inventory delivery profile integrations, add feature detection for market-driven shipping, and migrate to the new Market.delivery.shipping APIs before merchants flip the switch.
89
Opportunity
Shopify Developer Changelog
Official
Market-driven shipping Admin API
GraphQL Admin API 2026-07 supports market-driven shipping configuration: Market.delivery.shipping exposes shipping options attached directly to a market, removing the need for separate shipping profile resources in many cases.
Why it matters: The new API model is the target surface for shipping integrations under market-driven shipping. Apps that build shipping calculators, 3PL/4PL rate engines, or shipping automation should plan to move from DeliveryProfile to Market.delivery.
Action: Prototype against Market.delivery.shipping; map current delivery profile features (rates, conditions, carriers) to the new model; design a coexistence plan for shops not yet on market-driven shipping.
89
Opportunity
Shopify Developer Changelog
Official
Storefront Catalog MCP now implements UCP
Storefront Catalog MCP adds UCP-compatible tools: search_catalog, lookup_catalog, and get_product, enabling buyer-context-aware catalog interactions for AI agents.
Why it matters: Shopify pushing UCP as the agentic commerce protocol of choice; apps building on storefront APIs should expect agent-driven traffic and design tools around these new endpoints.
Action: Map current catalog read logic to the new MCP tools; instrument agent-style sessions; ensure filters, pagination, and variant selection signals are exposed.
88
Opportunity
Shopify Developer Changelog
Official
Market-driven shipping now available in feature preview
Market-driven shipping enters feature preview: shipping options attach directly to Markets, with rate variation by product and location conditions, replacing merchant delivery profiles as the source of truth.
Why it matters: This is a structural shift in how shipping is configured on Shopify. Apps reading or writing shipping/delivery data must plan a migration path away from merchant delivery profiles; merchants gain clearer checkout rate behavior. Wide agency and app dev impact.
Action: Opt shops into the preview where appropriate; inventory current delivery profile usage; brief merchants on the new per-Market shipping model and timeline to GA.
88
Urgent
Shopify Developer Changelog
Official
New discount fields in the Storefront API's cart types
Storefront API 2026-07 restructures discount fields on Cart: cart.discountAllocations and cartDiscountAllocation.discountApplication deprecated in favor of line-level and deliveryGroup allocations with sourceDiscountApplication.
Why it matters: Headless storefronts must rewire discount displays, totals, and analytics to the new shape before 2026-04 sunsets.
Action: Audit cart.headless/Storefront API consumers for the deprecated fields; migrate to lines[].discountAllocations and deliveryGroups[].discountAllocations; track sourceDiscountApplication for attribution.
87
Urgent
Shopify Developer Changelog
Official
Shopify CLI 4.0: SemVer, auto-updates, removing deprecated flags and commands
Shopify CLI 4.0 introduces SemVer, automatic updates, and removes the deprecated --force flag from shopify app deploy.
Why it matters: Tooling change that affects every app and theme developer workflow; automatic updates can change behavior without explicit action, and the --force removal requires script updates.
Action: Pin CLI versions as needed; remove any --force usage from shopify app deploy commands and CI scripts; review automatic update settings.
87
Evaluate
Shopify Developer Changelog
Official
`ActionBar` removed on mobile: `TitleBar` primary action now renders as an icon button
Polaris TitleBar's primary action on mobile now renders as an icon-only button in the header, with secondary actions moving to an overflow menu, replacing the prior bottom ActionBar.
Why it matters: Breaking visual change for admin/embedded apps on mobile; primary action must supply an icon, or developers must adapt to the new layout.
Action: Audit every TitleBar with a primaryAction; ensure icon props are set or remove the primaryAction; test on iOS/Android Shopify Mobile.
87
Urgent
Shopify Developer Changelog
Official
Hydrogen April 2026 release
Hydrogen v2026.4.0 bumps Storefront and Customer Account APIs to 2026-04; introduces breaking changes to consent handling and removes the proxyStandardRoutes option (Storefront API proxy is always on).
Why it matters: Headless Hydrogen merchants must upgrade and reconfigure any custom proxy routing; consent flow changes require UX and compliance review.
Action: Upgrade Hydrogen to v2026.4.0; remove proxyStandardRoutes usage; review consent banner logic against the new handler behavior.
87
Evaluate
Shopify Developer Changelog
Official
Configure order attribution for sales channel apps
Sales channel apps can configure order attribution definitions (API 2026-07+) to attribute orders beyond default app/channel level (e.g., marketplace, region, account).
Why it matters: Improves attribution accuracy for non-storefront channels, enabling better ROAS reporting and channel performance decisions.
Action: Review your sales channel app attribution and add definitions for surfaces/regions/accounts where default attribution is too coarse.
86
Evaluate
Shopify Developer Changelog
Official
Identify cart lines by `view_key` in `cartLinesUpdate` and `cartLinesRemove`
cartLinesUpdate and cartLinesRemove Storefront API mutations now accept viewKey as an alternative to line id for identifying cart lines.
Why it matters: Enables headless and Liquid storefronts to mutate cart lines using the same identifier rendered client-side, removing the need to map between viewKey and UUID id.
Action: Adopt viewKey in cartLinesUpdate/cartLinesRemove inputs where appropriate; confirm mutual exclusivity with id/lineIds and update typed schemas.
86
Evaluate
Shopify Developer Changelog
Official
`totalUnsettledSet` calculation fixed for pending captures
OrderTransaction.totalUnsettledSet no longer double-counts authorization + pending capture amounts; returns the actual unsettled sum.
Why it matters: Bug fix to a financial field. Any app reporting unsettled funds, reconciliation, or treasury workflows may have been over- or under-reporting pending captures.
Action: Audit reconciliation/reporting logic; verify historical vs. corrected values for pending-capture scenarios and notify finance stakeholders if discrepancies exist.
86
Opportunity
Shopify Developer Changelog
Official
New retail cash management capabilities
Cash management on Shopify POS rebuilt from the ground up with new Admin GraphQL APIs (CashDrawer resource) and POS UI extension targets for cash drawer, cash sessions, and cash transactions.
Why it matters: Unlocks previously impossible custom POS workflows for cash handling: multi-drawer reconciliation, loss-prevention integrations, accounting sync, and third-party cash management apps. Directly relevant to POS app developers and agencies building retail client solutions.
Action: Review the new CashDrawer, CashSession, and related GraphQL API docs. Prototype an app or extension that adds value on top of the new endpoints (e.g., reconciliation, accounting push, anomaly detection). Update any existing cash-related integrations to use the new resource model.
86
Opportunity
Shopify Developer Changelog
Official
More admin intents now support Settings
Seven new admin Settings intents let apps deep-link merchants into notifications, payment capture, gift cards, delivery profiles, and business details editors.
Why it matters: Lowers merchant setup friction for apps by jumping directly to the relevant settings section, improving onboarding and conversion for apps that configure merchant options.
Action: Adopt the new Settings intents in onboarding flows and support docs to guide merchants to correct settings without manual instructions.
86
Opportunity
Shopify Developer Changelog
Official
Multi-channel support for sales channel apps
Sales channel apps can now create and manage multiple channel connections per shop, with separate specifications or external accounts per connection.
Why it matters: Removes the need to ship duplicate apps for multi-region or multi-account sales channel strategies; lowers build and maintenance cost for channel partners.
Action: Refactor sales channel apps to support multiple connections per installation; update onboarding and listing copy to reflect multi-channel capability.
86
Urgent
Shopify Developer Changelog
Official
`BusinessEntity` now exposes `legalEntityId` in the GraphQL Admin API
BusinessEntity in GraphQL Admin API (2026-07) now exposes legalEntityId, a stable BigInt identifier for legal entities across shops and markets.
Why it matters: Gives partners a persistent cross-shop identifier for the same legal entity, simplifying multi-store reporting, compliance, and integrations.
Action: Adopt legalEntityId in partner integrations to unify identity across shops/markets; deprecate shop-scoped heuristics where possible.
85
Opportunity
Shopify Developer Changelog
Official
Bots and agents should identify themselves via Web Bot Auth
Stricter Storefront API and online store rate limits applied to unidentified bots; signing with Web Bot Auth unlocks higher limits.
Why it matters: Operators of crawlers, AI agents, or competitive intelligence bots hitting storefronts must adopt Web Bot Auth to avoid throttling; affects SEO/AI tooling vendors.
Action: If operating a bot/agent against Shopify storefronts, implement Web Bot Auth signing before enforcement tightens.
85
Opportunity
Shopify Developer Changelog
Official
`inventoryActivate` now preserves `available` quantity
inventoryActivate in API 2026-04 no longer resets available/onHand to zero when omitted, retaining prior active inventory quantities for the location.
Why it matters: Reduces a known footgun that silently wiped stock counts on reactivation; existing apps may have been masking this with manual quantity restoration.
Action: Audit inventoryActivate call sites to determine if you were relying on (or working around) the zero-reset behavior; remove now-unnecessary restore logic.
85
Opportunity
Shopify Developer Changelog
Official
Metaobject access in Shopify Functions
As of GraphQL API 2026-04, all Shopify Functions can access app-owned metaobject entries, enabling functions to query structured data like tiered pricing and bundles.
Why it matters: Significantly expands the data accessible inside Functions - now discount, shipping, payment, and other Functions can leverage metaobjects for tiered pricing, bundles, and custom merchandising logic without external lookups.
Action: Audit existing Functions to identify opportunities to pull configuration from app-owned metaobjects instead of metafields or hardcoded values. Prototype discount/shipping functions that dynamically read metaobject-backed rule sets.
85
Urgent
Shopify Developer Changelog
Official
Payment method identifier now required for customerPaymentMethodRemoteCreate
Starting 2026-07, the payment method identifier is required for customerPaymentMethodRemoteCreate when used with Stripe, Authorize.net, or Braintree remote payment method inputs.
Why it matters: Forward-looking breaking change: apps integrating these gateways must update payloads well before the 2026-07 cutoff or face failed payment method creation. Suggests ongoing payment-method-API consistency work.
Action: Inventory all usages of customerPaymentMethodRemoteCreate with the three mentioned gateways. Schedule codebase updates to include the identifier field before 2026-07. Add CI checks or test fixtures covering required fields.
84
Urgent
Shopify Developer Changelog
Official
OrderDisplayFulfillmentStatus now returns FULFILLMENT_NOT_REQUIRED for orders with no items to fulfill
OrderDisplayFulfillmentStatus enum gains a new FULFILLMENT_NOT_REQUIRED value as of API 2026-10, returned for orders with nothing left to fulfill (fully cancelled or fully refunded).
Why it matters: This additive enum change can flip dashboards, alerts, and order routing logic if apps treat UNFULFILLED and 'nothing-to-fulfill' as equivalent. Backward-compatible, but dashboards, WMS, and reporting should handle the new state explicitly.
Action: Update integrations consuming OrderDisplayFulfillmentStatus to handle FULFILLMENT_NOT_REQUIRED; separate it from UNFULFILLED in filtering, automation rules, and SLA reporting.
84
Evaluate
Shopify Developer Changelog
Official
Inventory transfer webhooks include origin and destination location IDs, and mutation documentation clarified
Inventory transfer webhooks (add_items, update_item_quantities, remove_items, ready_to_ship, cancel, complete) now include origin and destination location Global IDs; docs clarified.
Why it matters: Removes the need for apps to call back for transfer endpoints, enabling faster and more reliable inventory transfer handling for OMS, 3PL, and fulfillment apps.
Action: Update webhook payload schemas to consume origin/destination Location Global IDs and adjust any code that currently fetches these via a follow-up query.
84
Urgent
Shopify Developer Changelog
Official
Customer tax settings now available in Admin API
Customer.taxSettings becomes publicly queryable in Admin GraphQL API 2026-07, exposing tax IDs (e.g., VAT) collected at checkout under read_customers or read_taxes scopes.
Why it matters: Unlocks B2B/VAT-aware customer data in apps without scope hacks; parity with CompanyLocation.taxRegistrationId enables unified tax ID retrieval.
Action: Plan API version bump to 2026-07 if your app needs customer-level tax IDs; request read_taxes scope where required; update tax exemption displays.
84
Evaluate
Shopify Developer Changelog
Official
App-owned metaobjects can be used without access scopes
App-owned metaobjects (including declarative metaobject definitions with $app: type prefixes) can now be used by the owning app without requesting access scopes.
Why it matters: Removes a friction point in app install flows - merchants no longer need to approve additional scopes for an app to read/write its own metaobjects. Lowers install friction and clarifies a previously confusing scope model.
Action: If your app uses app-owned metaobjects, audit your scope requests and remove any related scope requests that are no longer necessary. Update install flows and scope justification copy accordingly to reduce merchant friction.
84
Opportunity
Shopify Developer Changelog
Official
Metafield translations now available via GraphQL Admin API
The Metafield type now exposes a translations field on the GraphQL Admin API, enabling querying of localized metafield values for products, collections, customers, orders, locations, and more.
Why it matters: Removes a major gap in headless and international commerce workflows. Apps handling i18n/translation now have a first-party API path instead of scraping admin interfaces or working around REST limitations.
Action: Update translation management apps and headless storefronts to query metafield translations via the new field. Replace any workarounds relying on Shopify's Translation API edge cases for metafields.
84
Opportunity
Shopify Developer Changelog
Official
Shipping line field now available on FulfillmentOrderLineItem
FulfillmentOrderLineItem now exposes a shippingLine field so apps can identify the shipping method per line item, even when fulfillment orders are merged across delivery profiles.
Why it matters: Removes ambiguity for fulfillment, 3PL, and ERP apps handling multi-profile merges; simplifies correct shipping-method attribution and label routing.
Action: Add shippingLine to relevant GraphQL queries in fulfillment integrations; update logic that previously reconciled shipping via separate calls.
84
Opportunity
Shopify Developer Changelog
Official
Shop User Metafields in Shopify Functions
Partners can now read Shop User metafields during checkout via Shopify Functions, enabling cross-merchant buyer personalization at checkout.
Why it matters: Unlocks personalized checkout logic (discounts, validation, routing) based on Shop Pay buyer identity across merchants.
Action: Audit Shop User metafield usage and design Functions that read them for personalization, fraud, or loyalty logic at checkout.
83
Urgent
Shopify Developer Changelog
Official
Carrier services will no longer be automatically added to the default shipping profile
Starting with API 2026-10, creating a carrier service via the Admin GraphQL or REST API no longer auto-adds the service to the shop's General shipping profile; this is a breaking change.
Why it matters: Apps that create carrier services implicitly relied on auto-association; after this change, newly created carrier services may be inactive in checkout unless explicitly attached. Existing shipping flows can break silently.
Action: Update carrier service creation flows to explicitly associate the new service with shipping profiles (or Market.delivery) as part of the same workflow; add tests for 2026-10 readiness.
83
Evaluate
Shopify Developer Changelog
Official
Customize /llms.txt, /llms-full.txt and /agents.md
Stores can now serve custom content at /llms.txt, /llms-full.txt, and /agents.md via Liquid templates under Online Store > Themes > Edit code.
Why it matters: Gives merchants control over how AI agents and LLM crawlers see their catalog and policies; relevant to AI-driven discovery and shopping experiences.
Action: Decide whether default agents.md content is acceptable; if not, add templates/agents.md.liquid (and optionally llms.txt.liquid, llms-full.txt.liquid) to curate AI-facing content.
83
Urgent
Shopify Developer Changelog
Official
Function run log details are now automatically visible with the right access scopes
Function run logs in the Dev Dashboard are now visible to apps with the necessary access scopes, removing the need for merchants to manually share logs with app developers.
Why it matters: Speeds up debugging of Shopify Functions for app developers and reduces support overhead for merchants granting access.
Action: Confirm function input queries and required scopes so that run logs are visible without extra merchant steps; update debugging runbooks accordingly.
83
Evaluate
Shopify Developer Changelog
Official
Publish and unpublish product variants independently from product
ProductVariant becomes Publishable in API 2026-07, allowing per-publication visibility without deleting or duplicating products.
Why it matters: Gives merchants and apps fine-grained catalog control per channel, simplifying multi-channel merchandising and headless setups.
Action: Plan migration to API 2026-07 and refactor publishing logic to operate at the variant level; review channel strategy assumptions.
83
Opportunity
Shopify Developer Changelog
Official
Add Prerequisites to Product Discount Functions
Product discount functions now support prerequisites, enabling full Buy X Get Y (BXGY) discount logic where customers must purchase a specified quantity of one product to receive a discount on another.
Why it matters: Completes the discount function toolkit - previously prerequisite logic for BXGY had to be enforced elsewhere. Significantly expands what merchandising teams can build natively via Shopify Functions, reducing reliance on third-party discounting apps.
Action: Plan migration of any custom BXGY logic into native product discount functions using prerequisites. Build apps/extensions offering advanced bundle mechanics (tiered bundles, cross-sell prerequisites) that compete with existing BXGY apps.
83
Opportunity
Shopify Developer Changelog
Official
Cart and checkout validation adds billing address and PO number error targets
Cart and Checkout Validation Functions now support new field targets for billing address and PO number validation starting 2026-04, enabling server-side enforcement for B2B orders.
Why it matters: Replaces brittle client-side UI validation with robust server-side enforcement. Critical for B2B merchants needing strict billing rules (blocked countries, required PO numbers) that can't be bypassed by client-side tricks.
Action: Audit existing checkout UI extensions for billing-country and PO enforcement and migrate logic into Cart/Checkout Validation Functions. Prototype new compliance-checking apps for regulated industries.
83
Evaluate
Shopify Developer Changelog
Official
Default value of `appliesOnSubscription` changed to `true` for app discount inputs
appliesOnSubscription default flips to true on DiscountCodeAppInput and DiscountAutomaticAppInput. Existing apps setting it explicitly are unaffected.
Why it matters: Apps that rely on implicit defaults may unintentionally apply discounts to subscription orders, changing checkout behavior and revenue recognition for subscription merchants.
Action: Audit discount-creation code to explicitly set appliesOnSubscription where subscription exclusion is intended; regression-test subscription checkout paths.
83
Evaluate
Shopify Developer Changelog
Official
Minor rounding change for custom line item discounts in POS 11.5
POS 11.5 applies fixed-amount custom line item discounts per-unit instead of across the line, affecting discount rounding.
Why it matters: Apps calling setLineItemDiscount/bulkSetLineItemDiscounts with FixedAmount may see different discount totals in POS 11.5+.
Action: Test POS 11.5 behavior for fixed-amount discounts and recalibrate any totals, taxes, or receipts expectations.
82
Opportunity
Shopify Developer Changelog
Official
[DRAFT] Markets APIs now support MarketRegionSubdivision
Markets APIs now expose a stable MarketRegionSubdivision type for country-subdivision (state/province) market regions in the Admin GraphQL API 2026-07 release candidate.
Why it matters: Sub-region markets let merchants run more granular pricing, shipping, and tax strategies tied to states/provinces. Apps that read or write market conditions need to migrate from generic region unions to MarketRegionSubdivision to avoid query breakage as merchants opt in.
Action: Audit any GraphQL queries touching market region conditions and update to use MarketRegionSubdivision. Read sub-region membership via market.conditions.regionsCondition.regions.
82
Opportunity
Shopify Developer Changelog
Official
Shopify AI Toolkit for upgrading extensions to Polaris web components
Shopify AI Toolkit now supports upgrading checkout and customer account UI extensions to new API versions, including the migration to Polaris web components, usable with preferred AI coding agents.
Why it matters: Reduces manual migration cost for agencies and app developers on upcoming extension API versions; signals that Polaris web components are the default forward path for checkout and customer account UI extensions.
Action: Pilot the AI Toolkit on a non-critical extension migration; track which upgrades it handles correctly versus ones still requiring manual review.
82
Opportunity
Shopify Developer Changelog
Official
Build App Home as a UI extension
App Home can now be built as a Preact-based admin UI extension using the new admin.app.home.render target, eliminating the need for a separate web server for the app's primary workspace.
Why it matters: Lowers the cost and complexity of shipping App Home by reusing the existing UI extension bundle; consolidates app distribution into the Shopify admin.
Action: For new apps, design App Home as a UI extension target; for existing apps with hosted App Home, evaluate migration to the bundled extension model.
82
Urgent
Shopify Developer Changelog
Official
Scannable discount codes
Merchants can now generate QR codes for any discount code, usable by POS staff at checkout and online customers. No app changes required for discount apps.
Why it matters: Adds a new redemption surface (POS + online) for discount codes without API work; relevant for discount, POS, and marketing apps to consider QR-aware features or compatibility testing.
Action: Review your discount-creation flows for optional QR generation; confirm URL format works with current deep-link/receipt patterns.
82
Urgent
Shopify Developer Changelog
Official
DraftOrderLineItem.grams field removed in 2026-07
DraftOrderLineItem.grams is being removed in Admin GraphQL API 2026-07 after 8+ years deprecated; queries will error once 2026-04 is unsupported.
Why it matters: Hard removal of a long-deprecated field; any app still on grams needs to swap to the typed weight field before the unsupported cutoff.
Action: Search codebases for DraftOrderLineItem.grams; replace with weight { value unit }; pin target API version to 2026-04 or later.
82
Urgent
Shopify Developer Changelog
Official
Removing outdated Polaris reference docs
Polaris reference docs now follow a 12-month minimum support versioning policy, mirroring GraphQL API versioning. Older versions continue to work but lose dedicated reference docs starting with 2026-04.
Why it matters: Sets clear expectations and tightens alignment with API versioning. Teams on older Polaris versions need to plan upgrade timelines to avoid documentation gaps when troubleshooting.
Action: Inventory which Polaris versions your apps/extensions target. Plan upgrades to versions within the 12-month support window. Verify CLI version requirements before deploying.
82
Opportunity
Shopify Developer Changelog
Official
Identifier support added to the productUpdate mutation
productUpdate mutation now accepts an id/handle/customId identifier argument so callers can reference products by handle or a metafield-based customId without pre-fetching the global product ID.
Why it matters: DX improvement for integrations syncing product data from external systems (ERP, PIM, marketplaces) where global IDs may not be known. Reduces round-trips and simplifies error handling for ID resolution.
Action: Update product sync integrations and bulk update scripts to use handle or customId where appropriate. Reduce reliance on lookup-then-update flows.
82
Evaluate
Shopify Developer Changelog
Official
Add `isActive` field to `InventoryLevel`
As of API version 2026-04, InventoryLevel gains an isActive boolean and apps can optionally query inactive inventory levels.
Why it matters: Apps must distinguish active vs. inactive levels to avoid selling against deactivated stock or double-counting inventory across locations.
Action: Update inventory queries to filter on isActive where appropriate; communicate behavior changes to merchants and partners reliant on prior implicit filtering.
82
Evaluate
Shopify Developer Changelog
Official
Tax Partner apps can now receive cart line properties in tax calculation requests
Tax partner apps can receive cart line item properties (e.g., personalization, gift_wrap) in tax calculation requests starting API 2026-04.
Why it matters: Allows tax engines to account for taxable vs. non-taxable customizations, improving accuracy for personalized products and reducing merchant compliance risk.
Action: Tax partners should update their property subscription lists and validation; merchants with personalized SKUs should verify tax behavior with their tax app.
82
Opportunity
Shopify Developer Changelog
Official
`GiftCardCashOutTransaction` is now resolvable from `GiftCardTransaction`
GraphQL Admin API 2026-07 introduces GiftCardCashOutTransaction as a new GiftCardTransaction interface variant for POS payouts.
Why it matters: Allows POS and reporting apps to distinguish gift card cash-out events from other transactions for accurate reconciliation.
Action: Update GraphQL queries to handle the new GiftCardCashOutTransaction variant when reconciling POS gift card payouts.
81
Urgent
Shopify Developer Changelog
Official
App quality checks now managed in Partner Dashboard
App quality audits now flow through the same Partner Dashboard review experience as new app submissions, with requirement tracking, structured fix workflow, and direct messaging.
Why it matters: Centralizes app compliance workflows in the Partner Dashboard, making it easier for app teams to track required fixes and respond to Shopify review feedback.
Action: Check existing published apps for outstanding quality check items in Partner Dashboard > App > Distribution and assign owners to each requirement.
81
Opportunity
Shopify Developer Changelog
Official
Add `includeInactive` argument to `inventoryLevels` and `inventoryLevel` fields
GraphQL Admin API 2026-04 exposes includeInactive: true on inventoryLevels / inventoryLevel queries so apps can finally retrieve deactivated inventory levels.
Why it matters: Restores data completeness for inventory sync, multi-location reporting, ERP integrations, and audit tooling that previously had to reconstruct inactive states via REST.
Action: Migrate inventory reads to API 2026-04+; decide whether to default includeInactive on for reporting endpoints or keep off for hot-path stock queries.
81
Opportunity
Shopify Developer Changelog
Official
`delegateAccessTokenCreate` mutation now returns `expiresIn`
The delegateAccessTokenCreate GraphQL mutation now returns an expiresIn field (seconds until expiry), aligning with the REST Admin API's delegate endpoint behavior.
Why it matters: Removes a parity gap between GraphQL and REST for delegate tokens. App developers previously had to estimate expiry - now they can schedule refreshes accurately, reducing auth failures for background jobs and integrations.
Action: Update any delegate token usage in your apps to read the new expiresIn field and implement proper refresh scheduling. Replace any expiry-estimation logic.
81
Opportunity
Shopify Developer Changelog
Official
Analytics metric targets now available in the GraphQL Admin API
New GraphQL operations (analyticsTargets, analyticsTargetCreate, analyticsTargetUpdate, analyticsTargetsDelete) let apps manage merchant analytics goals and gauges.
Why it matters: Enables analytics/coaching apps to programmatically set and track merchant goals, opening room for goal-setting features tied to app value delivery.
Action: Integrate analyticsTarget operations into analytics dashboards or coaching workflows to let merchants track app-defined KPIs.
81
Urgent
Shopify Developer Changelog
Official
Removing deprecated PRIVATE and PUBLIC_READ enums on metaobject definitions
MetaobjectAdminAccess enum deprecates PRIVATE and PUBLIC_READ values; these are no longer returned by the API.
Why it matters: Code relying on these enum strings may break or misclassify access; cleaning up ensures accurate Storefront access handling.
Action: Search codebase for references to PRIVATE/PUBLIC_READ on metaobjects and migrate to current access semantics.
80
Opportunity
Shopify Developer Changelog
Official
Draft order deposit fields are now available in the GraphQL Admin API and Customer Account API
GraphQL Admin API 2026-07 and the Customer Account API expose draft order deposit fields, enabling partial payments at checkout with remaining balance due later (e.g., due-on-fulfillment).
Why it matters: Unlocks B2B and made-to-order use cases (deposits, layaway-style terms) on draft orders natively. Apps handling wholesale, custom, or pre-order flows can stop building bespoke deposit logic.
Action: Update draft order creation/update flows to set DraftOrderInput.deposit; ensure Customer Account API clients display deposit terms and remaining balances correctly.
80
Opportunity
Shopify Developer Changelog
Official
Streamlined Metaobject API
Metaobject API now exposes a values property returning a JSON-compatible object with all fields in a single call, and accepts JSON-style objects on create/update, removing manual serialization.
Why it matters: Lowers the friction of integrating metaobjects into apps and themes; reduces boilerplate and a class of serialization bugs for content-driven use cases.
Action: Switch metaobject reads/writes to use the values field where supported; confirm API version compatibility and fallback handling.
80
Opportunity
Shopify Developer Changelog
Official
mTLS client certificate renewal for Payments Apps
Shopify will rotate its mTLS client certificate for Payments Apps on June 15, 2026; the new cert chains to the same CA so most apps need no changes, but custom validation may need updates.
Why it matters: Hard deadline for any Payments App with custom cert pinning or strict validation; missed renewals break authentication.
Action: Confirm none of your Payments Apps hard-pin the current client cert; if they do, plan pin rotation before June 15, 2026.
80
Opportunity
Shopify Developer Changelog
Official
Tax summary webhook now includes merchant business entity information
Tax Partners receive a new merchant_business_entity field on the tax_summaries/create webhook starting 2026-04, enabling cross-shop entity mapping and accurate entity-aware tax calculation.
Why it matters: Critical for tax partners operating across multiple legal entities or marketplaces; eliminates guesswork about which legal entity should be taxed. Improves compliance accuracy for tax partner apps.
Action: Tax partner app developers should read merchant_business_entity from webhook payloads and incorporate it into entity-resolution logic and audit trails. Cross-shop reporting should account for entity boundaries.
80
Opportunity
Shopify Developer Changelog
Official
Improved user errors on the `fulfillmentOrderCancel` mutation
fulfillmentOrderCancel now returns a specific fulfillmentOrderCancelError with a code field instead of the generic userError, supporting new in-progress fulfillment order workflows.
Why it matters: Programmatic error handling becomes reliable for fulfillment and 3PL apps, especially as merchants gain manual in-progress state controls.
Action: Refactor error handling around fulfillmentOrderCancel to branch on the new error codes; update support runbooks.
