Deprecating the useBuyerJourneyIntercept API on checkout UI extensions
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on July 02, 2026.
This Shopify update is categorized as Action Required, Polaris, Deprecation announcement, 2026-07.
What changed
Starting in version 2026-07, the useBuyerJourneyIntercept hook on checkout UI extensions, and the block_progress capability it depends on, are deprecated. Existing extensions will continue to work on current and prior API versions, but this API will be removed in a future version, so you should plan to migrate. The following are deprecated: useBuyerJourneyIntercept (Preact hook) in checkout UI extensions The block_progress capability in the extension’s shopify.extension.toml configuration file If you currently use useBuyerJourneyIntercept to enforce merchant business rules, migrate to a cart and checkout validation Function. These Functions run server-side and apply your rules consistently across all checkout surfaces, including express wallets and agentic checkout.
Who is affected
Developers building or maintaining Shopify checkout UI extensions should review this change.
What action may be needed
Check whether your app uses the deprecated surface. If it does, plan the migration using Shopify's official guidance before the applicable cutoff.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →