FoxrFoxr
Triggers

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

SurfaceWhere
Post PurchaseThe Triggers tab of a funnel.
Thank You & Order StatusThe 1. Triggers tab of a funnel.
CheckoutWho sees this widget, on every widget. Only three trigger groups — there's no Order Details & Time Based Triggers group.
Customer AccountsNo 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.

GroupExamples
Product Based TriggersSpecific products, collections, variants, tags, types, quantities
Cart & Discount TriggersOrder value, item count, discount code
Customer Attribute TriggersCustomer tag, order history, order count, language, once per customer
Order Details & Time Based TriggersCurrency, 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:

KindWhich triggersWhat a match does
ExclusionExclude Specific Product, Exclude Specific Collection, Once per customer, any trigger set to Excludes, and Subscription set to do not include a subscriptionHides the funnel.
InclusionEverything elseShows 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 wantSet up
Show the funnel when the order contains a lip balmSpecific Product → the lip balm.
Show it for lip balms or hand creamsSpecific Product → both products. Or two inclusion triggers — either one matching is enough.
Show it to everyone except wholesale customersUntick Show this funnel to all customers, then Customer tag → Excludes → wholesale.
Show it for lip balm orders, but never to wholesale customersSpecific Product → the lip balm, plus Customer tag → Excludes → wholesale.
Show a funnel only during a weekend saleDate/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. Sale matches a tag sale, but not summer-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.

On this page