Targeting and Smart Rules

October 8, 2026

25 Smart Rules decide who sees an offer. They cover what's in the cart, what the cart is worth, who the shopper is, what they're looking at, and the surrounding context — including targeting many upsell apps don't have, like Klaviyo segment membership, B2B/wholesale status, Shopify Markets, customer province, device type, traffic source and date/time scheduling. Rules combine, and most accept both include and exclude lists, so a precise audience is one offer rather than several.

How rules combine

Rules are additive: every rule on an offer must pass for it to show. Adding a rule narrows the audience, never widens it. There's no “any of these” grouping across different rule types — if you need either/or logic, that's two offers with complementary rules.

Most rules take an include list and an exclude list, and exclude wins. That lets you write “customers tagged VIP, except in these markets” as one rule instead of two. An empty include list means no restriction rather than “match nothing”, so exclude-only rules work fine.

Within a single rule, a list is an any-of match — a shopper in any one of three Klaviyo segments passes. Across rules it's all-of. That combination is what lets one offer describe a broad audience narrowed on several axes at once.

What you can express

Because rules compose, specificity is a matter of stacking two or three of them:

  • “Shoppers in the EU market, with more than €80 in cart, who aren't tagged wholesale” — Markets + Cart Value + Customer Tags (exclude).
  • “Anyone viewing a product in the Cameras collection, on mobile, who doesn't already have a memory card in their cart” — Trigger Collections + Device Type + Cart Products (exclude).
  • “Subscription customers in Canada, during the first week of December” — Subscription in Cart + Shipping destination + Date & Time Scheduling.
  • “Shoppers from paid traffic who haven't applied a discount code” — Traffic Source + Discount Code Applied.

None of those need custom code, a second app, or duplicate offers.

Cart contents

RuleWhat it targetsInclude / exclude
Cart ProductsSpecific products in the cartBoth
CollectionsCart contains a product from given collectionsBoth
Specific Product Variants in CartExact variants, not just the parent productBoth
Product TagsTags on products in the cartBoth
Cart AttributesCustom cart attributes — gift message, delivery date, anything your theme writesBoth
Subscription ProductsSpecific subscription products in the cartBoth
Subscription in CartWhether the cart contains any subscription at allRequired / none

Cart value and quantity

RuleWhat it targetsInclude / exclude
Cart ValueTotal cart valueMinimum and maximum
Collection Cart ValueSpend within given collections, or the whole cartMinimum and maximum, and several conditions can stack
Cart Product QuantityUnits of given products or collections — countable across all lines, or only subscription or only one-time linesMinimum and maximum, and several conditions can stack

Audience

RuleWhat it targetsInclude / exclude
MarketsThe Shopify Market being browsedBoth
Shipping destination countryWhere the order is actually goingBoth
Customer Province / StateSub-national regionBoth
Customer TagsShopify customer tagsBoth
Klaviyo SegmentKlaviyo segment membership, from a synced copy rather than a live API callBoth, plus a choice of how to treat unknown membership
Customer LanguageShopper's language, with base-language fallbackBoth
Device TypeMobile or desktopBoth
B2B / WholesaleWhether the customer is a B2B buyerBoth
Retail LocationsWhich physical store — point of sale onlyBoth

Trigger — product page only

RuleWhat it targetsInclude / exclude
Trigger ProductsThe specific product being viewedBoth
Trigger CollectionsAny product from given collections being viewedBoth

These are the only rules that read the page itself rather than the cart, which is why they're specific to the product page — and why genuine pairing logic lives there.

Context

RuleWhat it targetsInclude / exclude
Date & Time SchedulingDate range, days of the week, specific dates and hour windowsRange, plus include/exclude per dimension
Discount CodesWhich codes are applied to the cartBoth
Discount Code AppliedWhether any code is applied at allPresence
Traffic SourceWhere the shopper arrived fromBoth

A few behaviours worth knowing

Language matching falls back by base language. A shopper on en-DE matches a rule targeting en. Target en-US and you'll match en-US and en, but not en-DE.

Discount codes match case-insensitively, because Shopify treats them that way and shoppers type any casing.

Scheduling runs in local time, and its four dimensions combine — so a weekend promotion, a specific date, and an hours window can all apply to one offer. Hour windows may wrap past midnight, so a 10pm–2am deal is one window rather than two.

Klaviyo membership can be unknown, and you decide whether unknown counts as in or out rather than the app guessing.

The same rules target more than offers

This isn't an offers-only feature. The identical targeting engine, with identical semantics, also governs reward programs and checkout customizations — so a condition means the same thing wherever you apply it, and you learn it once.

What you can build with it

Segment-aware offers without an export. Target a live Klaviyo segment — lapsed buyers, high-LTV, anyone in a specific flow — with no list syncing or tag maintenance.

Keep wholesale and retail separate. Exclude B2B buyers from consumer offers, or build an offer that only they see.

Protect margin on promotions. Suppress an upsell discount when the shopper already has a code applied.

Merchandise by what's in the basket. Offer the refill when the cart holds the hardware, targeted by collection so the whole range is covered by one rule.

Run retail and online from one account. Scope point-of-sale offers by store location so staff are only prompted with what's actually on the shelf.

FAQ

Can I show different offers in different countries? Yes. Target by Shopify Market, by shipping destination country, or by customer province or state — and combine any of them with other rules.

Can I exclude wholesale or B2B customers? Yes. The B2B / Wholesale rule targets or excludes B2B buyers, and most other rules accept an exclude list too.

Can I target my Klaviyo segments? Yes. Klaviyo segment membership is a native targeting rule — no list export or tag maintenance. Membership is resolved server-side from a continuously synced copy rather than a live API call, so it adds nothing to page load. You also choose how shoppers whose membership can't be resolved are treated.

Can I schedule offers for specific dates or times? Yes. Scheduling covers a date range, days of the week, specific dates and hour windows, evaluated in local time, and they combine.

Can I show a different offer on mobile than on desktop? Yes. Device Type targets mobile or desktop.

Can I target based on what's already in the cart? Yes — by product, variant, collection, product tag, cart attribute, cart value, unit quantity, or whether the cart contains a subscription. Quantity rules can count only subscription lines or only one-time lines if you need that distinction.

Can I stop an upsell discount stacking with a promo code? Yes. Target on whether a discount code is applied, or on which specific codes, and suppress the offer when one is present.

Can I combine several conditions on one offer? Yes, and that's the normal case. Every rule you add must pass, so stacking two or three produces a precise audience from a single offer.

Related Help Center articles

Try it on your store

Install UpsellPlus free and launch your first offer in minutes, or book a walkthrough with our team.