Condition types
This page is a reference to all the available condition types and condition operators. See Conditions to learn more.
Scope and availability
Section titled “Scope and availability”The available condition types depend on the operation category. Conditions use the following scope:
| Operation category | Condition scope |
|---|---|
| Shipping | Conditions are evaluated separately for each current delivery group. Product, line item, destination, and shipping rate values come from that group. Cart-wide values, such as Cart Value and Shipment Count, keep their whole-checkout meaning. |
| Payment | Conditions are evaluated against the checkout as a whole, including all of its line items and delivery groups. Billing address and payment method values come from the checkout. |
The Available in column below shows where each condition type can be used.
Supported condition types
Section titled “Supported condition types”Customer
Section titled “Customer”| Condition type | Value type | Available in | What it reads |
|---|---|---|---|
| Customer Tags | String | All operations | Tags on the customer in checkout. A guest checkout has no customer tags, so a positive tag match does not match a guest. |
Destination address
Section titled “Destination address”| Condition type | Value type | Available in | What it reads |
|---|---|---|---|
| Country Code* | String | Shipping | The destination country code, such as US, CA, or GB. |
| Province Code* | String | Shipping | The destination province or state code. |
| Postal Code | String | Shipping | The destination postal or ZIP code. |
| UK Postcode Area** | String | Shipping | The area portion of the destination’s UK postal code, such as SW, EC, or B. |
| UK Postcode Outward Code** | String | Shipping | The outward code portion of the destination’s UK postal code, such as SW1A, W1, or EC1A. |
| P.O. Box | None | Shipping | Whether address line 1 or line 2 of the destination address looks like a P.O. Box. |
*Country and Province codes use the ISO-3166-1 alpha-2 and ISO-3166-2 specifications respectively.
**UK Postcode condition types use the Area and Outcode component of the postcode. Read more about UK Postcode format here.
Billing address
Section titled “Billing address”| Condition type | Value type | Available in | What it reads |
|---|---|---|---|
| Country Code* | String | Payment | The billing country code. |
| Province Code* | String | Payment | The billing province or state code. |
| Postal Code | String | Payment | The billing postal or ZIP code. |
| UK Postcode Area** | String | Payment | The area portion of the billing UK postal code, such as SW, EC, or B. |
| UK Postcode Outward Code** | String | Payment | The outward code portion of the billing UK postal code, such as SW1A, W1, or EC1A. |
| P.O. Box | None | Payment | Whether address line 1 or line 2 of the billing address looks like a P.O. Box. |
*Country and Province codes use the ISO-3166-1 alpha-2 and ISO-3166-2 specifications respectively.
**UK Postcode condition types use the Area and Outcode component of the postcode. Read more about UK Postcode format here.
Products
Section titled “Products”| Condition type | Value type | Available in | What it reads |
|---|---|---|---|
| Product Tags | String | All operations | Tags on products in the checkout scope. |
| SKU | String | All operations | The SKU of the variant on a line item in the checkout scope. |
Line items
Section titled “Line items”| Condition type | Value type | Available in | What it reads |
|---|---|---|---|
| Line Item Value | Number | All operations | The total value of line items, after discounts. |
| Line Item Weight | Number | All operations | The total weight of line items. |
| Line Item Quantity | Number | All operations | The total quantity of line items. |
Shipping rates
Section titled “Shipping rates”| Condition type | Value type | Available in | What it reads |
|---|---|---|---|
| Rate Title | String | All operations | The name shown for a shipping rate. |
| Rate Cost | Number | All operations | The numeric cost associated with a shipping rate. Use the currency shown for the checkout you are testing. |
| Service Code | String | All operations | The shipping rate’s Service Code. |
Payment methods
Section titled “Payment methods”| Condition type | Value type | Available in | What it reads |
|---|---|---|---|
| Payment Method Name | String | Payment | The name of a payment method in checkout. |
| Condition type | Value type | Available in | What it reads |
|---|---|---|---|
| Cart Value | Number | All operations | The total merchandise value of the entire cart, after discounts, but omitting shipping, taxes, and duties. |
| Shipment Count | Number | All operations | The number of “packages” in the checkout. This is based on how Shopify determines line item fulfillment, which can be affected by how many locations and Delivery Profiles are required to fulfill the order. |
How P.O. Box matching works
Section titled “How P.O. Box matching works”P.O. Box condition type operators skip the usual Value input — they use a predefined pattern that identifies whether address line 1 or line 2 is a P.O. Box. Recognized formats include “PO Box,” “P.O. Box,” “Post Office Box,” and “Postal Box” — typical street addresses, like “123 Boxwood Lane” or “456 Post Road,” won’t be mistaken for one.
If you have any questions or have an issue with P.O. Box matching, please contact us.