Trigger reference
Every trigger, its settings, and exactly what it checks — grouped the way they appear in the app.
Read How triggers work first — it explains how several triggers combine. Triggers marked exclusion below hide the funnel when they match; everything else shows it.
Product Based Triggers
| Trigger | Settings | Matches when |
|---|---|---|
| Specific Product | Add products (Shopify product picker) | The order contains any variant of any selected product. |
| Specific Variant | Add variants (variant picker) | The order contains any of the exact variants selected. |
| Specific Collection | Add collections | The order contains a product that's in any selected collection. |
| Exclude Specific Product (exclusion) | Add products | The order contains any selected product — and the funnel is hidden. |
| Exclude Specific Collection (exclusion) | Add collections | The order contains a product from any selected collection — and the funnel is hidden. |
| Product quantity | Add condition rows: More than, Less than, or Exactly, a number, and a product. Condition Logic: AND or OR between rows. | The order line for that product has the quantity you set. With AND, every row must match; with OR, any one. |
| Product tag | Includes or Excludes, and tags | Any product in the order has one of the tags. Excludes makes it an exclusion. |
| Product type | Includes or Excludes, and product types | Any product in the order has one of the types. |
| Variant name | Includes or Excludes, and variant names | Any variant in the order has one of the names, such as Red / Large. Products with no options are named Default Title. |
| Subscription | include a subscription or do not include a subscription | The order does (or doesn't) contain a subscription item. Do not include is an exclusion. |
Product quantity notes:
- More than 1 means 2 or more.
- Each row looks at one order line. If the customer bought two variants of the same product, they're separate lines and aren't added together.
- A row without a product never matches.
Subscription only works for Post Purchase funnels and checkout widgets. Thank You & Order Status funnels don't load subscription details, so there include a subscription never matches and do not include a subscription never hides the funnel.
Cart & Discount Triggers
| Trigger | Settings | Matches when |
|---|---|---|
| Order value | More than or Less than, and an amount | The order total is above or below the amount. More than 100 doesn't match exactly 100. |
| Quantity | More than, Less than, or Exactly equals, and a number | The total number of items in the order, across all lines, compares as set. |
| Discount code | Includes or Excludes, and codes | The order's discount code is one of the codes. |
| Discount percent (%) | — | Not available yet. |
Order value notes:
- The amount is compared in the currency the customer checked out in, with no conversion. The field always shows $, whatever your currency.
- Post Purchase uses the total the customer paid — after discounts, including shipping and tax, before any upsell.
- Thank You & Order Status uses the order's current total, which changes if the order is edited or an upsell is added.
- Checkout uses the checkout total for upsell widgets, and the subtotal for all other widget types.
Discount code notes:
- Not available on Post Purchase — Shopify doesn't share the discount code with the post-purchase page, so it never matches there.
- On the other surfaces, only the order's first discount code is checked.
Customer Attribute Triggers
| Trigger | Settings | Matches when |
|---|---|---|
| Customer tag | Includes or Excludes, and tags | The customer has one of the tags. |
| Customer order history | Customer previously ordered or Customer never ordered | The customer has (or hasn't) placed an order before this one. |
| Customer order count | More than, Less than, or Exactly equals, and a number | The customer's number of orders compares as set. |
| Customer language | One or more languages (Add language) | The customer shops in one of the languages. |
| Once per customer (exclusion) | — | The customer has already been shown this funnel on an earlier order — and the funnel is hidden. |
Notes:
- Guests — customers who check out without an account — have no tags and no previous orders. They match Customer never ordered and an order count of 0, and never match an Includes customer tag.
- Customer order history ignores the current order and has no time limit.
- Customer order count includes the order just placed on the post-purchase and thank you pages. A first-time buyer counts as 1 there. In checkout, the order hasn't been placed yet, so they count as 0.
- Customer language compares the language only. Regional variants such as Brazilian Portuguese or Traditional Chinese may not match the plain language.
- Once per customer only works for Post Purchase funnels. A customer counts as having seen the funnel once they've accepted or declined one of its offers. It has no effect on the thank you page or in checkout.
Order Details & Time Based Triggers
Post Purchase and Thank You & Order Status only — this group isn't available in checkout.
| Trigger | Settings | Matches when |
|---|---|---|
| Currency | Default store currency only or International currencies only | The order was (or wasn't) placed in your store's default currency. |
| Random sample | A percentage | A random draw falls within the percentage — for example, 10 shows the funnel to roughly 10% of orders. |
| Date/Time | Timezone, Starts on date and time, Ends on date and time | The current time is between the start and end. Switch on only Starts on for an open-ended start, or only Ends on for a deadline. |
| Shipping country | — | Not available yet. |
| Shipping method | — | Not available yet. |
| UTM parameters | — | Not available yet. |
Notes:
- Currency on post-purchase — Shopify only shows the post-purchase page for orders in your default currency, so this trigger only makes a difference for Thank You & Order Status funnels.
- Random sample is drawn once per post-purchase visit. On the thank you and order status pages it's drawn each time the page loads, so a customer can see the funnel on one visit and not the next.
- Random sample is an inclusion trigger like any other: combined with a product trigger, it adds a random share of all orders rather than sampling the product's orders.
- Date/Time is checked in UTC, whatever timezone you pick. Enter your start and end times in UTC.
Not available yet
These triggers appear in the app but can't be switched on, or don't match anything yet, because Shopify doesn't share the information the app would need:
| Trigger | Why |
|---|---|
| Discount percent (%) | Shopify doesn't share the order's discount percentage with post-purchase or checkout extensions. |
| Shipping method | Shopify doesn't share the chosen shipping method. |
| UTM parameters | UTM parameters aren't shared with post-purchase or checkout extensions. |
| Shipping country | Not evaluated yet. |
| Metafields | Product and variant metafield values aren't loaded yet, so this trigger doesn't match. |