Checkout gate
The Delivery Checkout Gate disables checkout buttons in the places your cart page doesn't cover — the cart drawer that slides out, the "added to cart" popup, and the cart icon in your header — until the customer selects a required delivery date.
Why there are two parts
| Part | Where it works |
|---|---|
| Delivery Calendar block | The cart page — shows the date picker |
| Delivery Checkout Gate | Everywhere else — blocks checkout buttons (cart drawer, popups) |
The block handles the date picker and the checkout button on the cart page itself. The gate covers every other place a customer can click Checkout.
Turn on the checkout gate
- Go to Online Store → Themes → Customize.
- Click Theme settings (the gear icon, bottom-left) → App embeds.
- Switch Delivery Checkout Gate on.
- Click Save.
Check it's working
- Go to your storefront and open a product page.
- Add the product to your cart so the cart drawer or "added to cart" popup appears.
- With a Required calendar and no date selected yet, the Checkout button should appear greyed out.
- Go to the cart page, pick a delivery date, then return — the checkout buttons become active again.
When checkout is blocked
The gate blocks checkout only when all of these are true:
- At least one calendar that applies to the cart is marked Required
- The cart contains products that use that calendar
- No delivery date has been selected yet for that calendar
Optional calendars never block checkout.
On the cart page
On the cart page, the date picker block already manages the checkout button, so the gate steps aside there to avoid doing the same job twice. You don't need to configure anything for this.
While dates are loading
For a moment after a page loads, the checkout buttons stay disabled while the available dates are fetched. There's no error message during this time — the buttons simply stay inactive until everything is ready, then unlock if no date is required.
Does this affect my theme or theme updates?
No. The checkout gate is added through Shopify's official app system — it does not edit your theme's files. You can update or switch themes without affecting it (you'll just turn the gate on again in the new theme).
Troubleshooting
| Issue | Fix |
|---|---|
| Checkout buttons never get blocked | The gate is off — turn it on under Theme settings → App embeds |
| Checkout still active everywhere | Your calendar may be optional — turn on Require a delivery date in Settings |
| Works on the cart page but not the cart drawer | The gate is off — switch it on |
| Gate is on but never blocks | The cart may be empty, or no calendar applies to the products in it |
Next step
Common questions: FAQ and troubleshooting →