Display conditions
Show or hide any section, row, column or element based on who is shopping and what's in their cart. Cart and checkout rules update live, without a page reload.
- A section selected on the canvas, Visibility tab open
- Hide on desktop, tablet and mobile
- Display conditions, set to Always show
Setting a condition
- Select the item
Any section, row, column or element, then open its Visibility tab.
- Choose the mode
Display conditions: Always show, Show only when… or Hide when…
- Fill in rules
Leave a rule empty (or 0) to ignore it. Match: All rules (default) or Any rule.
- Check the badge
The item shows a "Shown only when…" or "Hidden when…" badge in the editor. The editor preview always shows everything.
Rules
| Rule | Value | Example |
|---|---|---|
| Shopper | Anyone, Logged in or Guest | Guest |
| User roles | Role keys, comma-separated | customer, wholesale |
| Item quantity at least / at most | 0–9999 (0 = no limit) | at least 3 |
| Subtotal at least / at most | 0–1,000,000 (0 = no limit) | at least 50 |
| Contains products | Product or variation IDs | 12, 34 |
| Contains categories | Category slugs or IDs | shoes, 17 |
| Coupon applied | Coupon codes, or any | any |
| Shipping country | Two-letter codes (billing country if no shipping address) | US, CA |
| Shipping method | Method IDs or exact rate IDs | flat_rate, free_shipping, local_pickup or flat_rate:3 |
| Payment method | Gateway IDs. The help lists your store's enabled gateways ("This store: …"). | bacs, cod |
Lists are comma-separated and take up to 50 entries. Payment method uses the chosen gateway, or the first available one before the shopper picks. On the Thank You page, rules use the order being viewed instead of the cart.
How rules combine
- All rules: every filled-in rule must hold (AND).
- Any rule: one is enough (OR).
- Hide when… inverts the result.
- A hidden container hides everything inside it.
Live updates
On the Cart and Checkout pages, items with cart-based rules (quantity, subtotal, products, categories, coupons, country, shipping, payment) update as the shopper changes the cart, the address, the shipping method or the payment method. Form fields inside a hidden item are disabled, so they are never submitted. Shopper and role rules are decided when the page loads.
Conditions keep applying if your license lapses; you just can't edit them until you reactivate. See If a license lapses.
Ideas
Free-shipping nudge
Show Free Shipping Progress only when Subtotal at most 49.
Wholesale note
Show a Text element only for the role wholesale.
Bank transfer reminder
Show a note when Payment method is bacs.
Pickup instructions
Show directions when Shipping method is local_pickup.
Protected elements
Items that contain a required element (for example Cart Items, Billing Address, Payment Methods, Terms & Privacy or Place Order) can't carry conditions, because the page needs them. You'll see: Display conditions can't hide "…": the page needs it. Put the condition on another element.