---
title: >-
  Deprecating the useBuyerJourneyIntercept API on checkout UI extensions -
  Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/deprecating-the-usebuyerjourneyintercept-api-on-checkout-ui-extensions
  md: >-
    https://shopify.dev/changelog/deprecating-the-usebuyerjourneyintercept-api-on-checkout-ui-extensions.md
metadata:
  effectiveApiVersion: 2026-07
  affectedApi: []
  primaryTag:
    displayName: Polaris
    handle: polaris
  secondaryTag:
    displayName: Deprecation Announcement
    handle: deprecation
  indicatesActionRequired: true
  createdAt: '2026-06-29T09:57:50-04:00'
  postedAt: '2026-07-02T12:00:00-04:00'
  updatedAt: '2026-07-07T15:57:39-04:00'
  effectiveAt: '2026-07-01T12:00:00-04:00'
---

July 2, 2026

Tags:

* Action Required
* Polaris
* 2026-07

# Deprecating the useBuyerJourneyIntercept API on checkout UI extensions

Starting in version `2026-07`, the [`useBuyerJourneyIntercept`](https://shopify.dev/docs/api/checkout-ui-extensions/latest/target-apis/checkout-apis/buyer-journey-api#useBuyerJourneyIntercept) hook on checkout UI extensions, and the [`block_progress`](https://shopify.dev/docs/apps/build/checkout/capabilities#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.

If you currently use `useBuyerJourneyIntercept` to enforce merchant business rules, migrate to a [cart and checkout validation Function](https://shopify.dev/docs/api/functions/latest/cart-and-checkout-validation). These Functions run server-side and apply your rules consistently across all checkout surfaces, including express wallets and agentic checkout.

If you use `useBuyerJourneyIntercept` to reject discount codes, migrate that logic to the discount Function API, which [now supports rejecting discount codes with a custom message](https://shopify.dev/changelog/discount-rejection-support-for-discount-functions).

The following are deprecated:

* `useBuyerJourneyIntercept` (Preact hook) in checkout UI extensions
* The `block_progress` capability in the extension’s `shopify.extension.toml` configuration file