Shopify Deprecates useBuyerJourneyIntercept Hook for Checkout UI Extensions

What Changed

Shopify is deprecating the useBuyerJourneyIntercept hook and its associated block_progress capability in checkout UI extensions, starting with API version 2026-07. The deprecation affects extensions that currently use this client-side hook to control checkout flow progression. Extensions built on current and prior API versions will continue functioning, but developers should prepare for complete removal in a future version.

Migration Path for Developers

Shopify directs developers currently using useBuyerJourneyIntercept to enforce merchant business rules to migrate to cart and checkout validation Functions. Unlike the client-side hook, validation Functions run server-side, providing a more robust enforcement mechanism for checkout rules and restrictions.

Technical Implications

This change shifts validation logic from the client to the server. Developers relying on useBuyerJourneyIntercept for blocking checkout progress based on custom conditions need to rebuild this functionality using Shopify Functions. The server-side approach offers stronger enforcement since validation cannot be bypassed through client-side manipulation.

Apps that intercept the buyer journey for validation purposes should begin planning migration timelines. The deprecation notice provides advance warning, but developers should audit their extensions to identify dependencies on this hook. Testing validation Functions in development environments before the 2026-07 version release will help ensure smooth transitions for merchants using affected extensions.

Read the full announcement →