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.
92
Urgent
Shopify Developer Changelog
Official
Deprecation of checkout metafields in checkout and customer account UI extensions
Checkout metafields removed in 2026-04; replaced by cart metafields in checkout UI extensions and order metafields in customer account UI extensions.
Why it matters: Hard-breaking change for extension authors; required upgrade to a newer API version to avoid losing metafield access.
Action: Upgrade checkout/customer account extensions to API 2026-04 minimum; migrate to cart/order metafields accordingly.
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.
90
Opportunity
Shopify Developer Changelog
Official
Polaris web components migration guides now available for Checkout and Customer Account UI extensions
60+ component migration guides released for upgrading Checkout and Customer Account UI extensions from React/JS extension APIs to Preact, Polaris web components, and the global shopify object.
Why it matters: This is the practical migration runway for the deprecation chain (Checkout Profile/Branding APIs, checkout metafields); agencies and ISVs should plan component-level refactors against this new guide set.
Action: Review migration guides for any extension components in active use; budget refactor effort for Preact + Polaris web components adoption.
90
Evaluate
Shopify Developer Changelog
Official
Automatic CSS subsetting for `{% stylesheet %}` tags
Starting April 20, 2026, Shopify automatically delivers only the CSS from {% stylesheet %} tags relevant to rendered sections/blocks/snippets per page, instead of shipping all stylesheet CSS every load.
Why it matters: Theme-app performance change. Themes using self-contained class naming get faster storefronts for free; themes relying on globally-scoped utility classes may regress or break.
Action: Audit theme CSS architecture for cross-section class dependencies; consolidate globals into snippet-scoped files; benchmark CLS/LCP on mobile after rollout.
89
Urgent
Shopify Developer Changelog
Official
Standard storefront events and actions
Liquid storefronts now emit standard DOM events (e.g. shopify:product:view, shopify:cart:lines-update) and expose actions apps and agents can call, working across all themes.
Why it matters: Creates a uniform integration layer for themes, apps, and AI agents, reducing theme-specific custom hooks and unlocking cross-theme analytics and automation.
Action: Adopt standard events in themes and apps; deprecate theme-specific custom events where possible.
88
Opportunity
Shopify Developer Changelog
Official
Hydrogen developer preview
Next Hydrogen shifts commerce logic to a framework-agnostic core, supports any JS framework, and ships agent skills for storefront scaffolding.
Why it matters: Signals a strategic shift in Shopify's headless stack away from React Router coupling, opening storefront development to more frameworks and AI-assisted scaffolding.
Action: Watch the preview; pilot a small storefront against the framework-agnostic core if you build custom storefronts.
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.
88
Urgent
Shopify Developer Changelog
Official
`DraftOrderDiscountNotAppliedWarning.priceRule` removed in GraphQL Admin API 2026-10
DraftOrderDiscountNotAppliedWarning.priceRule is removed in Admin API 2026-10, breaking queries in draftOrderCalculate/Create/Update.
Why it matters: Hard breaking change for any app querying priceRule on draft order discount warnings; failing queries will return errors in 2026-10.
Action: Remove priceRule from DraftOrderDiscountNotAppliedWarning selections; ship before 2026-10 cutoff.
87
Opportunity
Shopify Developer Changelog
Official
New Collection model and APIs now available
API 2026-07 replaces collection ruleSet with multi-source CollectionSource objects (typed inclusions/exclusions plus manual) and adds variant-level collection membership to Functions.
Why it matters: Modernizes the collection data model and unlocks more complex merchandising logic, but requires migration planning for apps that touch collections.
Action: Assign an owner, check whether the store or app stack is affected, and decide whether a migration or audit is needed.
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.
86
Urgent
Shopify Developer Changelog
Official
Storefront MCP cart tools are being deprecated in favour of UCP Cart MCP
Storefront MCP cart tools (get_cart, update_cart) are deprecated in favor of UCP-conforming Cart MCP tools (create_cart, etc.) at the new /api/ucp/mcp endpoint, implementing the UCP cart capability spec.
Why it matters: AI shopping agents and integrations using Storefront MCP must move to UCP Cart MCP to remain functional, aligning with the cross-platform Universal Commerce Protocol. Strategic for AI Commerce builders.
Action: Migrate AI agent and integration code from Storefront MCP cart tools to UCP Cart MCP at /api/ucp/mcp; validate against the UCP 2026-04-08 cart spec.
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.
85
Opportunity
Shopify Developer Changelog
Official
Apps can now open Shopify’s file picker with the Intents API
Apps can launch Shopify's native file picker via the Intents API, with media filters, multi-select, and preselection support in a single call.
Why it matters: Removes the need for apps to build custom file pickers or detour merchants through external upload flows, simplifying asset workflows for editors and marketers.
Action: Replace any custom file pickers with the Intents API file picker; document the new flow for merchants.
84
Opportunity
Shopify Developer Changelog
Official
Color palettes in Themes
Themes now support a color_palette setting type that merchants edit in one grid, with section/block-level overrides preserved alongside existing color schemes.
Why it matters: Simplifies merchant customization of themes and gives agencies a new pattern for centralized color management while preserving fine-grained control.
Action: Audit active themes for color palette opportunities; build new themes using the color_palette setting where appropriate.
84
Opportunity
Shopify Developer Changelog
Official
New `PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION` warning code in the Storefront API Cart
Storefront API Cart emits PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION warning per affected line in API 2026-07, targeted to CartLine ID.
Why it matters: Headless storefronts and apps can detect geo-restricted products in cart and proactively show alternatives, reducing checkout drop-off on international markets.
Action: Update Storefront API clients to handle the new warning code; render line-level messaging in cart UI.
84
Opportunity
Shopify Developer Changelog
Official
New CSS variable for mobile safe area insets
New --shopify-safe-area-inset-bottom CSS variable lets embedded apps on Shopify Mobile offset fixed-position UI away from the host's floating navigation bar.
Why it matters: Removes a common iOS/Android clipping footgun for embedded app developers without manual measurement hacks.
Action: Use var(--shopify-safe-area-inset-bottom) in fixed/sticky layouts across Shopify Mobile; remove any manual height-offset workarounds.
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
Urgent
Shopify Developer Changelog
Official
Hydrogen now deploys to Vercel
Hydrogen developer preview adds a one-click Deploy to Vercel flow using the Next.js starter template, no local setup required.
Why it matters: Lowers the barrier for headless Shopify storefronts on Hydrogen/Vercel; agencies and merchants can stand up a working storefront faster.
Action: Test Vercel deploy flow from Hydrogen template; document for clients evaluating headless storefronts.
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
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
Urgent
Shopify Developer Changelog
Official
`discountedUnitPrice` on `DraftOrderLineItem` Customer Account API deprecation
DraftOrderLineItem.discountedUnitPrice in Customer Account API is deprecated in favor of approximateDiscountedUnitPrice (per-unit average of discounted total / qty).
Why it matters: Per-unit discounted pricing was misleading on multi-quantity or discount-allocated lines; switching avoids pricing display bugs in customer-facing draft order UIs.
Action: Replace discountedUnitPrice with approximateDiscountedUnitPrice in all Customer Account API queries for draft orders.
83
Evaluate
Shopify Developer Changelog
Official
Read a cart line's `viewKey` from the `CartLine` type
CartLine now exposes a viewKey field in responses, letting you correlate returned cart lines with the viewKey you sent in cartLinesUpdate/cartLinesRemove.
Why it matters: Removes a long-standing footgun where Liquid cart lines could not be round-tripped via the API; simplifies PDP/cart UIs and headless storefronts.
Action: Update cart response handlers to read CartLine.viewKey; align client-side cart state with API responses.
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
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
Evaluate
Shopify Developer Changelog
Official
Shop Minis May June 2026 update
Shop Minis adds typed React SDK hooks (useSelectVariant, useAddToCart, useBuyNow) that wrap Shopify product variant intents, enabling native variant selector and express checkout from inside a Mini.
Why it matters: Shop Minis is a growing surface inside Shop app; these hooks let Mini developers trigger core commerce flows without building custom UIs, accelerating Mini commerce capability.
Action: Adopt useSelectVariant/useAddToCart/useBuyNow in Minis handling variant SKUs; test variant selector sheet and express checkout path before shipping.
82
Opportunity
Shopify Developer Changelog
Official
Line item component information now available for draft orders on the Customer Account API
Customer Account API 2026-04 adds DraftOrderLineItem.components plus a flattenComponents argument on DraftOrder.lineItems.
Why it matters: Customer accounts can now display component/bundle line items for draft orders, improving transparency for B2B and custom orders.
Action: Update Customer Account API draft order rendering to handle component line items or set flattenComponents explicitly.
81
Opportunity
Shopify Developer Changelog
Official
Discount application information now available for draft orders on the Customer Account API
Customer Account API (2026-07) exposes discountApplications on DraftOrder and discountAllocations on DraftOrderLineItem, letting customer-facing surfaces show draft order discounts.
Why it matters: B2B and wholesale buyers on customer accounts can now see accurate discount breakdowns on draft orders, reducing back-and-forth and quote-to-order conversion friction.
Action: Surface discountApplications in customer account draft order views; update B2B/headless storefronts querying DraftOrder.
81
Opportunity
Shopify Developer Changelog
Official
Feature preview: Customer account improvements
Customer accounts are getting a visual refresh (single-column native pages, inline extensions render narrower) available as a feature preview.
Why it matters: Agencies and merchants building customer account extensions must test their UI in the new layout to avoid regressions before the default rollout.
Action: Enable preview on a dev store; audit inline extension widths, navigation, and mobile layout; brief design teams.
81
Evaluate
Charle Articles
Agency POV
Charle mobile SEO guide connects Shopify mobile UX with Core Web Vitals and checkout speed
Charle explains mobile SEO for Shopify stores through mobile-first indexing, Core Web Vitals, checkout speed, and product schema.
Why it matters: Mobile SEO and mobile conversion are no longer separate checklists for most Shopify stores.
Action: Audit a mobile product page for LCP, INP, tap targets, Shop Pay visibility, and product schema.
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.
