Storefront API 2026-07 Adds PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION Warning to Cart
Handle the PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION warning by mapping the warning’s target CartLine ID to the UI and notifying the buyer.
Update your storefront integration to check for PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION warnings on cart lines and display an appropriate message to the buyer.
Summary
Starting with the 2026‑07 release of the Storefront API, the Cart object emits a new warning, PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION, whenever a cart line contains a product that is not available in the buyer’s location. Each affected cart line returns its own warning, and the warning’s target is set to the CartLine ID so developers can map it back to the UI. The warning is intended to help merchants inform buyers about product availability constraints before checkout. The warning type is defined in the CartWarning object and can be handled programmatically using the existing cart warnings documentation. No other changes to cart behavior are introduced in this version. Developers should update their storefront integrations to check for this warning and display an appropriate message to the buyer. The change is documented in the Storefront API 2026‑07 release notes and example code is available in the Shopify docs.
Key changes
- 2026‑07 Storefront API Cart now emits PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION warning.
- Warning triggers when a cart line contains a product unavailable in the buyer’s location.
- Each affected cart line returns its own warning.
- Warning target is set to the CartLine ID for UI mapping.
- Warning is defined in the CartWarning object.
- No other cart behavior changes in this release.
- Developers should check for this warning and display a message to the buyer.
- Documentation and example code are provided in Shopify docs.