# Conditions: when a function applies

FunctionFlow AI · Build functions · Updated October 3, 2026

> Combine conditions with ALL or ANY, group and invert them, check items in the cart, and understand exactly how each condition is matched at checkout.

Conditions decide **when** a function’s actions run. They live in the **When** card of the [builder](https://help.fleekapps.com/functionflow-ai/visual-builder/). With no conditions, the function applies to every checkout.

![The When card with two conditions: Country is any of US, and State / province is any of AK, HI](https://help.fleekapps.com/media/functionflow-ai/conditions.webp "Two conditions that must both match: the order ships to Alaska or Hawaii.")

## Add a condition

1. Click **Add condition**.
2. Click **Choose a condition…** and pick what to check. Type to search, use the arrow keys to move and press Enter to choose.
3. Pick an operator, such as **is at least**, **has any of** or **is between**.
4. Enter the value.

![The condition picker open, with a search box and conditions grouped by Product and Shipping](https://help.fleekapps.com/media/functionflow-ai/condition-picker.webp "The condition picker lists only the conditions this kind of function can check.")

The picker only lists conditions that work for the kind of function you’re building — Shopify gives each kind different cart data. The full list is in the [condition reference](https://help.fleekapps.com/functionflow-ai/condition-reference/).

Under each condition you may see a short hint, such as how *Cart total* is calculated. To remove a condition, click the bin icon.

## ALL, ANY and groups

The toggle at the top of the card sets how conditions combine:

- **ALL** — every condition must match (they’re joined with **AND**).
- **ANY** — at least one condition must match (joined with **OR**).

To mix the two, add a group. In an ALL group, **Add OR group** adds a nested group whose conditions are joined with OR — for example *the customer is tagged VIP* **and** (*the cart total is over $100* **or** *the cart has 3+ items*). In an ANY group the button is **Add AND group**. Groups can be nested up to four levels deep.

### Invert

Tick **Invert** to run the actions only when a group does **not** match. The header changes from *Match* to *Unless*, and the summary reads *not (…)*. For example, invert *Customer tags has any of wholesale* to apply a rule to everyone except wholesale customers.

## Operators and values

The operators depend on what you’re checking:

| You’re checking | Operators |
|---|---|
| Amounts and numbers (cart total, quantity…) | is greater than, is at least, is less than, is at most, is, is not, is between |
| Weight | is greater than, is at least, is less than, is at most, is between |
| Text (product type, ZIP, city…) | is, is not, is any of, is none of, contains, does not contain, starts with, ends with, is empty, is not empty |
| Countries | is any of, is none of |
| Tags | has any of, has all of, has none of |
| Collections | has any of, has none of |
| Products and variants | is any of, is none of |
| Yes/no (logged in, PO Box, on sale…) | is true, is false |
| Time of day | is between |
| Day of the week | is, is not |

And the value box changes to match:

- **Amounts** show your store’s currency; **weights** have a unit picker (g, kg, lb, oz).
- **Lists** (tags, countries, ZIP codes, names) take several values: type one and press Enter or a comma. Paste a comma- or line-separated list to add many at once.
- **Products, variants and collections** open Shopify’s product picker so you can choose items from your store.
- **Time of day** has two time fields; **Day of the week** has seven day buttons, Monday first.
- **Cart attribute** and **Line property** ask for the attribute or property name first, then its value.

## Conditions about items in the cart

Some conditions look at the products in the cart rather than the cart as a whole.

### On any, every or no item

Product conditions such as **Product tags**, **Product type**, **Collection** or **Line quantity** have an extra choice:

- **on any item** (default) — at least one cart item matches.
- **on every item** — all items match (and the cart isn’t empty).
- **on no item** — no item matches.

So *Product tags has any of preorder on every item* means the cart only contains pre-order products.

### Item conditions with a product filter

**Cart has items**, **Quantity of items** and **Subtotal of items** look at a set of products you choose. Under the condition, pick **Any product** or **Only products that match…** and build a small filter, for example *Product tags has any of candle*. Then *Quantity of items is at least 3* means “at least 3 candles”.

> **Tip:** To say “the cart doesn’t contain X”, use **Cart has items** → **doesn’t have these items** with a filter for X. It checks the whole cart, which is usually what you mean.

## How conditions are matched at checkout

- **Upper and lower case are ignored** for text, tags, names and codes, and extra spaces are trimmed.
- **Tags must match a whole tag.** *vip* matches the tag *VIP* but not *VIP-gold*.
- **ZIP codes ignore spaces**, so *SW1A 1AA* and *SW1A1AA* are the same.
- **Several values mean “any of them”.** *Product type contains shirt, tee* matches either.
- **Missing information never matches**, except with negative operators. If the address isn’t entered yet, *Country is any of US* is false, while *Country is none of US* is true.
- **Guests** have no tags, 0 orders and 0 spent. Use **Customer is logged in** to target only signed-in customers.
- **PO Box** detection looks for *PO Box*, *P.O. Box*, *Post Office Box* or *POB* in the first address line.
- **Cart total** is the subtotal before discounts in discount functions, and the cart total in payment, shipping and checkout rules.
- **Times and days** use your store’s time zone. See [Happy hours and time-based rules](https://help.fleekapps.com/functionflow-ai/happy-hours-and-time-rules/).

## Limits

- One **cart attribute** name, one **line property** name and one **time-of-day** window per function.
- Up to 100 different customer tags, product tags or collections per function.
- A function’s whole configuration can be at most 10 KB — the meter in **What it does** shows how close you are.

If something isn’t allowed, the builder explains why right under the condition.

## Check your logic

Read the **What it does** summary after every change, then run the [quick test](https://help.fleekapps.com/functionflow-ai/test-a-function/) with a cart that should match and one that shouldn’t. The test’s **Why** section shows each condition with ✓ or ✕ and the value the function saw.

---
Source: https://help.fleekapps.com/functionflow-ai/conditions/