> ## Documentation Index
> Fetch the complete documentation index at: https://codebeans-shipping-rules-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Dynamic rate conditions

> Every condition a dynamic rate can use, and the operators each one accepts.

A dynamic rate only quotes when its conditions match. This page lists every condition available, and the operators each one accepts.

Conditions are built in the dynamic rates editor — see [Setting up dynamic rates](https://codebeans-shipping-rules-pro.mintlify.site/dynamic-rates/setting-up.md) for the editor itself.

![The condition picker, grouped by section](https://mintcdn.com/codebeans-shipping-rules-pro/q4ulWG3dWji5cRla/images/37-dynamic-condition-picker.jpg?fit=max\&auto=format\&n=q4ulWG3dWji5cRla\&q=85\&s=0fab879d40ed0e744176b0ac4e8dea08)

The condition picker, grouped by section

## How conditions fit together

* A rule holds up to **5 conditions**.
* Each condition holds up to **5 sub-conditions** — several tests against the same field, so "cart total is between 50 and 200" is one condition with two sub-conditions.
* **Match type** decides how the conditions combine:
  * **AND** — *"Every condition below has to be true for the rate to apply."*
  * **OR** — *"The rate applies as soon as one condition is true, even if the others are false."*

![Two conditions combined with AND — the badge between them shows how they join](https://mintcdn.com/codebeans-shipping-rules-pro/q4ulWG3dWji5cRla/images/38-dynamic-conditions-configured.jpg?fit=max\&auto=format\&n=q4ulWG3dWji5cRla\&q=85\&s=f048a39db41ca6d1885155692088b5ec)

Two conditions combined with AND — the badge between them shows how they join

> [!WARNING]
>
> With **OR** selected, each condition is enough on its own. A rule meant as "subtotal in range **and** email doesn't contain X" will still quote for an in-range subtotal whatever the email says. The editor warns you about this when you pick OR with more than one condition — choose **AND** if every condition has to hold.

![The warning the editor shows when OR is selected with more than one condition](https://mintcdn.com/codebeans-shipping-rules-pro/q4ulWG3dWji5cRla/images/39-dynamic-or-caution.jpg?fit=max\&auto=format\&n=q4ulWG3dWji5cRla\&q=85\&s=a7340aa85e4fdc615fb316fee6e989e1)

The warning the editor shows when OR is selected with more than one condition

## Cart

| Condition | What it checks |
| - | - |
| Cart total | The total value of the cart, with discounts applied |
| Cart subtotal | The subtotal value of the cart, without discounts applied |
| Cart discount applied | The total discount applied to the cart |
| Order weight | The total weight of the order |

> [!WARNING]
>
> **Cart total** relies on the order total the checkout sends. Some checkouts don't send one — when that happens the app falls back to the cart **subtotal**, so a discounted cart compares as if it were undiscounted. If a discount has to be respected, use **Cart subtotal** plus **Cart discount applied** instead of relying on Cart total alone.

## Customer

| Condition | What it checks |
| - | - |
| Customer tag | Whether the customer has any of the tags provided |
| Customer email | The email address of the customer |
| Customer first name | The first name of the customer |
| Customer last name | The last name of the customer |

> [!NOTE]
>
> Customer conditions need [Protected Customer Data access](https://shopify.dev/docs/apps/launch/protected-customer-data) approved for the app in your Partner Dashboard. Without it the app can't read these fields at checkout.

## Destination

Read from the buyer's shipping address.

| Condition | What it checks |
| - | - |
| Destination country | The country of the destination address |
| Destination postal code | The postal code of the destination address |
| Destination province | The province of the destination address |
| Destination city | The city of the destination address |
| Destination name | The name on the destination address |
| Destination address line 1 | The first address line |
| Destination address line 2 | The second address line |
| Destination address line 3 | The third address line |
| Destination phone | The phone number on the destination address |
| Destination fax | The fax number on the destination address |
| Destination address type | The type of the destination address |
| Destination company name | The company name on the destination address |

## Origin

Read from the fulfillment location the order ships from.

| Condition | What it checks |
| - | - |
| Origin country | The country of the origin address |
| Origin postal code | The postal code of the origin address |
| Origin province | The province of the origin address |
| Origin city | The city of the origin address |
| Origin address line 1 | The first address line |
| Origin address line 2 | The second address line |
| Origin phone | The phone number on the origin address |

> [!NOTE]
>
> Shopify locations carry fewer fields than a buyer's address, so **origin name, origin company name, origin address line 3, origin fax and origin address type** aren't offered — there's nowhere in Shopify to set them, and a rule using one could never match. The destination equivalents *are* available, because a buyer's address genuinely carries a name and a company.

## Item

Checked against each line in the cart.

| Condition | What it checks |
| - | - |
| Items attribute | An item's attribute value |
| Item name | An item's name |
| Item SKU | An item's SKU |
| Item quantity | An item's quantity |
| Item weight (grams) | An item's weight |
| Item price | An item's price |
| Item vendor | The vendor of the item |
| Requires shipping | Whether the item requires shipping |
| Taxable | Whether the item is taxable |
| Fulfillment service | The fulfillment service of the item |
| Product ID | The product ID of the item |
| Variant ID | The ID of the variant associated with the item |

> [!WARNING]
>
> On item conditions, a negative operator is checked **per line**, so it only passes when *every* line in the cart fails to match. "Item vendor is not Acme" won't apply to a cart that has one Acme product alongside others. The editor flags this when you pick a negated operator on an item field.

## Rate

| Condition | What it checks |
| - | - |
| Currency | The currency used for the rate calculation |
| Locale | The locale used for the rate calculation |

## Operators

Which operators appear depends on the field you picked.

**Numeric fields** — cart total, cart subtotal, cart discount applied, order weight, item quantity, item weight, item price:

Equals · Not equals · Greater than · Greater or equal · Less than · Less or equal

**Exact-match lists** — country, customer tag, product ID, variant ID, currency, locale:

Any · Not any

**Text fields** — customer email, customer names, province, city, address lines, phone, destination name:

Partially contains · Partially does not contain · Any · Not any

**Postal code, fax, address type, destination company name:**

Partially contains · Partially does not contain · Any · Not any · Starts with · Not starts with · Ends with · Not ends with

**Item name, item SKU, item vendor, fulfillment service:**

Partially contains · Partially does not contain · Any · Not any · Is Null · Is Not Null

**Items attribute:**

Partially contains · Partially does not contain · Any · Not any · True · False

**Requires shipping, Taxable:**

True · False

> [!NOTE]
>
> **Any / Not any** take a list — enter several values separated by commas. On numeric fields, type digits only; a value like a postal code belongs in a text field, where leading zeros and a `+` prefix are preserved.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.