Cart Qualifiers

Cart qualifiers are conditions based on the contents and properties of the customer’s cart. They determine when a campaign activates.

Available Cart Qualifiers

Condition	Code	Operators	Input Type
Cart/Item Subtotal	st	gt, lt, gte, lte, eq	Standard & Advanced
Cart/Item Quantity	qty	gt, lt, gte, lte, eq	Standard
Cart Total Weight	tw	gt, lt, gte, lte, eq	Standard
Cart Has Items	hi	(uses item selector)	Standard & Advanced
Cart Has Not Items	hni	(uses item selector)	Standard & Advanced
Cart Has Only Items	hoi	(uses item selector)	Standard & Advanced
Cart Has Attribute	ha	match / not match	Advanced only
Discount Code/Title	dc	match / not match / starts with / ends with / contains	Standard & Advanced
Market	m	is one of / is not one of	Standard
Language	lg	is one of / is not one of	Standard

Subtotal (st)

Compare the cart subtotal against a value. Supports all comparison operators (greater than, less than, equal, etc.).

Subtotal behavior options:

Cart subtotal (cs) — the total value of all items in the cart.
Qualified item subtotal (qis) — the subtotal of only items that match the campaign’s item selectors.

Example: Cart subtotal greater than $50 triggers free shipping.

Quantity (qty)

Compare the total number of items in the cart.

Quantity behavior options:

Cart total quantity (ctq) — count of all items in the cart.
Qualified item total quantity (qiq) — count of only items matching the item selectors.

Example: Cart quantity greater than or equal to 3 triggers a volume discount.

Total Weight (tw)

Compare the total weight of all items in the cart.

Supported weight units:

Grams (g)
Kilograms (kg)
Ounces (oz)
Pounds (lb)

Example: Cart total weight greater than 10kg hides express shipping.

Cart Has Items (hi)

Check if the cart contains specific items. Uses an item selector to define which items to look for.

You can additionally check:

Quantity — the cart has at least X of the matching items.
Subtotal — the matching items total at least $X.

Example: Cart has items from collection “Summer” with quantity >= 2.

Cart Has Not Items (hni)

The opposite of “has items” — check that the cart does NOT contain specific items.

Example: Cart has not items with tag “excluded” — apply discount only if no excluded products are present.

Cart Has Only Items (hoi)

Check that the cart contains ONLY items matching the selector. If any non-matching item is present, the condition fails.

Example: Cart has only items from collection “Clearance” — apply a clearance-specific discount.

Cart Has Attribute (ha)

Advanced input only. This qualifier is only available when the function uses Advanced input.

Check for the presence and value of a cart attribute (key-value pair).

Operators: match / not match

Example: Cart attribute _gift_wrap matches “yes” — add gift wrapping fee.

Discount Code/Title (dc)

Check the discount code or discount title applied to the cart.

Operators:

Match / Not match
Starts with / Ends with
Contains
Plus negation variants of each

Values can be comma-separated for matching against multiple codes.

Example: Discount code starts with “VIP” — apply additional VIP discount.

Market (m)

Target specific Shopify markets.

Operators: Is one of / Is not one of

Select from your configured market handles.

Example: Market is one of “EU” — apply a 20% regional discount.

Language (lg)

Target specific languages/locales.

Operators: Is one of / Is not one of

Select from locale codes (en, fr, de, es, etc.).

Example: Language is one of “fr” — show French-specific promotional messaging.

Multi-Condition Logic

All cart qualifiers support combining multiple conditions:

Meets all conditions (AND) — every condition must be true for the campaign to activate.
Meets any conditions (OR) — at least one condition must be true.

You can nest qualifier groups. For example: Cart qualifier (all conditions) + Customer qualifier (any condition) inside a single campaign.

Example: Cart subtotal > $100 AND cart has items from “Premium” collection AND market is “US.”