Storefront widgets
Cart re-verification
Re-checking the cart and gating checkout.
The last check before money changes hands. The cart widget re-verifies every line against the active vehicle and, if you want, refuses to open checkout until a problem is resolved.
Why a second check exists#
The product page verdict was correct when the item went in. Then the shopper switched vehicles in the garage, or opened a saved cart from three weeks ago, or added from a link a friend sent. Fitment that only runs on the product page lets all of those reach checkout.
What it does#
- Per-line verdict
- each cart line shows the vehicle it was added for and its current status.
- Re-verification
- every line is re-checked against the active vehicle on cart load and after any vehicle change.
- Per-line vehicle change
- a shopper buying for two cars can correct one line without emptying the cart.
- Checkout gate
- optional. Blocks the checkout button while a line does not fit, with copy you write.
The gate is a business decision#
Off by default. Turning it on prevents returns and prevents sales, and which matters more depends on your customer:
- Retail-heavy stores usually turn it on. A blocked checkout costs one conversation; a wrong lift kit or a wrong set of four wheels costs heavy freight, twice, plus a restock.
- Builder-heavy stores usually leave it off, because their customers deliberately buy things that don't "fit" by any envelope. A warning with an acknowledgement is the middle ground.
Placement#
A section block on the cart template. Themes with a cart drawer also need the app embed so the drawer gets the same treatment — a gate that only works on the cart page is not a gate.
Matching lines to rows#
The widget matches cart lines to the theme's DOM rows by cart item key first, then by a product link containing the variant ID, and only falls back to index order as a last resort. Shopify's cart order does not always match the rendered row order, and getting this wrong shows a shopper the wrong verdict on the wrong product.
Settings#
- Gate: off, warn, or block
- Warning and blocked copy
- Whether to show the vehicle on each line
- Whether to offer "find one that fits" links for no-fit lines
Support is answered by the people who wrote this code — not a ticket queue.