Customer conditions

Last updated: July 18, 2026

Customer conditions target who is buying: country, state or province, customer tags, login status, lifetime order count, and lifetime spend. They power location-based compliance fees (only Colorado pays the delivery fee) and customer-class rules (wholesale accounts skip the surcharge).

Customer country

Rules: is one of, is not one of. Value: two-letter ISO codes, comma-separated (US,DE,JP).

The codes are the ones Shopify uses in addresses, and they are not always the obvious letters: GB is the United Kingdom, DE Germany. Logged-in customers match by their default address country; guests by the cart's shipping address or, failing that, the storefront-detected country. Country DE is half of the Pfand rule; is not one of your home markets drives an international handling fee.

Timing note. A logged-in customer's default address is cached briefly (up to about 3 minutes). After editing an address, allow a few minutes plus a cart change before the fee reacts.

Customer state / province

Rules: is one of, is not one of. Value: comma-separated codes (CO,MN,CA).

The precision tool for US state fees: CO for the Colorado Retail Delivery Fee, MN for Minnesota, CA for CRV and the e-waste fee. Guests match once the cart has a shipping address; several states combine in one list for multi-state programs like mattress recycling.

Customer tag

Rules: contains, does not contain, is one of, is not one of.

Matches tags on the customer record, so it works for logged-in customers (guests never match a positive rule). The classic B2B lever: tag wholesale pays a handling fee, or is exempted from one, without touching your products. Tag edits take up to a few minutes (cache) plus a cart change to show.

Customer is logged in

Rules: is equal to. Values: yes / no.

Whether the session belongs to a signed-in customer. Charge guests a verification or handling fee that account holders skip, or make a fee exclusive to account holders. Updates on the next cart change after login.

Customer order count (lifetime)

Rules: is greater than or equal to, is less than or equal to, is equal to, is not equal to.

The number of orders the logged-in customer has placed in your store; guests never match. Is equal to 0 targets true first-time buyers (a new-customer service fee), at least 5 waives a fee for regulars. Shopify updates the count with a short delay and may skip unpaid or cancelled orders, so treat it as roughly right rather than instant.

Customer total spent (lifetime)