FoxrFoxr
Triggers

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

TriggerSettingsMatches when
Specific ProductAdd products (Shopify product picker)The order contains any variant of any selected product.
Specific VariantAdd variants (variant picker)The order contains any of the exact variants selected.
Specific CollectionAdd collectionsThe order contains a product that's in any selected collection.
Exclude Specific Product (exclusion)Add productsThe order contains any selected product — and the funnel is hidden.
Exclude Specific Collection (exclusion)Add collectionsThe order contains a product from any selected collection — and the funnel is hidden.
Product quantityAdd 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 tagIncludes or Excludes, and tagsAny product in the order has one of the tags. Excludes makes it an exclusion.
Product typeIncludes or Excludes, and product typesAny product in the order has one of the types.
Variant nameIncludes or Excludes, and variant namesAny variant in the order has one of the names, such as Red / Large. Products with no options are named Default Title.
Subscriptioninclude a subscription or do not include a subscriptionThe 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

TriggerSettingsMatches when
Order valueMore than or Less than, and an amountThe order total is above or below the amount. More than 100 doesn't match exactly 100.
QuantityMore than, Less than, or Exactly equals, and a numberThe total number of items in the order, across all lines, compares as set.
Discount codeIncludes or Excludes, and codesThe 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

TriggerSettingsMatches when
Customer tagIncludes or Excludes, and tagsThe customer has one of the tags.
Customer order historyCustomer previously ordered or Customer never orderedThe customer has (or hasn't) placed an order before this one.
Customer order countMore than, Less than, or Exactly equals, and a numberThe customer's number of orders compares as set.
Customer languageOne 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.

TriggerSettingsMatches when
CurrencyDefault store currency only or International currencies onlyThe order was (or wasn't) placed in your store's default currency.
Random sampleA percentageA random draw falls within the percentage — for example, 10 shows the funnel to roughly 10% of orders.
Date/TimeTimezone, Starts on date and time, Ends on date and timeThe 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:

TriggerWhy
Discount percent (%)Shopify doesn't share the order's discount percentage with post-purchase or checkout extensions.
Shipping methodShopify doesn't share the chosen shipping method.
UTM parametersUTM parameters aren't shared with post-purchase or checkout extensions.
Shipping countryNot evaluated yet.
MetafieldsProduct and variant metafield values aren't loaded yet, so this trigger doesn't match.

On this page