How triggers work
Decide which orders and customers see a funnel or widget — and exactly how several triggers combine.
Triggers are conditions that decide whether a funnel shows for a given order — the order contains this product, the customer has this tag, the order is worth more than $100.
Where you'll find them
| Surface | Where |
|---|---|
| Post Purchase | The Triggers tab of a funnel. |
| Thank You & Order Status | The 1. Triggers tab of a funnel. |
| Checkout | Who sees this widget, on every widget. Only three trigger groups — there's no Order Details & Time Based Triggers group. |
| Customer Accounts | No triggers of their own. Surfaces that recommend products use your Thank You & Order Status funnels and their triggers. |
Show to everyone, or only some orders
At the top of the tab is Show this funnel to all customers. It's ticked on every new funnel.
- Ticked — every order sees the funnel. The triggers below are greyed out and ignored (they're kept, so you can come back to them).
- Unticked — the triggers decide.
In checkout the same choice is two options: Show this configuration to all customers and Show this configuration conditionally.
The trigger groups
Triggers come in four collapsible groups. The header of each shows how many triggers in it are switched on.
| Group | Examples |
|---|---|
| Product Based Triggers | Specific products, collections, variants, tags, types, quantities |
| Cart & Discount Triggers | Order value, item count, discount code |
| Customer Attribute Triggers | Customer tag, order history, order count, language, once per customer |
| Order Details & Time Based Triggers | Currency, random sample, date and time |
Tick a trigger's checkbox to switch it on, then fill in its settings. See the trigger reference for every trigger.
How triggers combine
There are two kinds of trigger:
| Kind | Which triggers | What a match does |
|---|---|---|
| Exclusion | Exclude Specific Product, Exclude Specific Collection, Once per customer, any trigger set to Excludes, and Subscription set to do not include a subscription | Hides the funnel. |
| Inclusion | Everything else | Shows the funnel. |
The app decides like this:
If any exclusion trigger matches the order, the funnel is hidden. Exclusions always win.
Otherwise, if at least one inclusion trigger matches, the funnel shows.
If no inclusion triggers are switched on at all, the funnel shows to everyone who wasn't excluded.
In other words: inclusion triggers are combined with OR. Each one you add lets more orders in. Exclusion triggers are how you narrow a funnel down.
Examples
| You want | Set up |
|---|---|
| Show the funnel when the order contains a lip balm | Specific Product → the lip balm. |
| Show it for lip balms or hand creams | Specific Product → both products. Or two inclusion triggers — either one matching is enough. |
| Show it to everyone except wholesale customers | Untick Show this funnel to all customers, then Customer tag → Excludes → wholesale. |
| Show it for lip balm orders, but never to wholesale customers | Specific Product → the lip balm, plus Customer tag → Excludes → wholesale. |
| Show a funnel only during a weekend sale | Date/Time with a start and end. Don't add other inclusion triggers, or orders outside the dates will match those instead. |
Adding an inclusion trigger widens the audience
Specific Product plus Order value more than $100 shows the funnel for every order containing the product and for every order over $100 — not only orders that meet both. You can't require two inclusion triggers at once. Instead, pick the one inclusion trigger that matters most and narrow it with exclusion triggers.
Unticking 'show to all' isn't enough on its own
If you untick Show this funnel to all customers but don't switch on any inclusion trigger, the funnel still shows to everyone except the orders your exclusion triggers catch.
Which funnel wins
Each order sees at most one funnel per surface.
- Post Purchase — one active funnel with at least one offer whose triggers match. You can't set an order between post-purchase funnels, so make sure any one order can only match one of them.
- Thank You & Order Status — active funnels are checked in priority order (drag rows on the funnel list to set it). The first one that matches wins, and no lower funnel is tried — even if the winner ends up with nothing to show.
- Checkout — widgets of the same type are checked from top to bottom; see Place the checkout block.
Things to know
- Only active funnels are checked. An inactive funnel never shows, whatever its triggers say.
- Text values need Enter. For tag-style triggers — product tag, product type, variant name, discount code, customer tag — type the value and press Enter to add it as a chip. There's no Add button.
- Matching ignores capitals, but not partial words.
Salematches a tagsale, but notsummer-sale. - Tags and collections are read live. They're checked when the funnel is evaluated, not copied from the moment the order was placed.
- Guests have no customer data. A customer who checks out without an account has no tags and no previous orders.
- An empty trigger never matches. A trigger that's ticked but has no products, tags, or value does nothing — and if it's your only inclusion trigger, the funnel never shows.
Next
Trigger reference — every trigger and its settings.