Condition Types

RateTell supports 24+ condition types to create precise shipping rules. Conditions are organized into six categories.

Cart-Based Conditions

Condition	Operators	Example Use Case
Cart Total	`=` `≠` `>` `<` `≥` `≤` `between`	Cart Total ≥ $50 → Free shipping
Cart Weight	`=` `≠` `>` `<` `≥` `≤` `between`	Weight > 50 lb → Freight
Cart Item Count	`=` `≠` `>` `<` `≥` `≤` `between`	Item Count ≥ 5 → Bulk discount

Units: Cart Total (currency), Cart Weight (lb/kg/oz/g), Item Count (number)

Product Conditions

Condition	Operators	Example Use Case
Specific Product	contains, does_not_contain, contains_only, any	Contains: iPhone → AppleCare shipping
Collection	in, not_in, only_from	In: "Electronics" → Special rate
Product Tag	has, does_not_have, has_all, has_any	Has: "Fragile" → Special handling
Vendor	is, is_not, is_any_of	Is: "Nike" → Brand-specific shipping

Configuration: Search/autocomplete for products, collections, tags, and vendors. Multi-select supported.

Customer Conditions

Condition	Operators / Options	Example Use Case
Customer Tag	`has` `does_not_have` `has_all` `any`	Has: "VIP" → VIP perks
Customer Type	`first_time` `returning` `wholesale`	First Time → Welcome discount
Order Count	`=` `≠` `>` `<` `≥` `≤` `between`	Order Count ≥ 10 → Loyalty shipping
Customer LTV	`=` `≠` `>` `<` `≥` `≤` `between`	LTV ≥ $1000 → High-value perks

Note: Customer must be logged in. First Time = 0 orders, Returning = 1+ orders.

Location Conditions

Condition	Operators / Patterns	Example Use Case
Country	`is` `is_not` `is_any_of`	Is: "United States" → Domestic rates
State/Province	`is` `is_not` `is_any_of`	Is Any Of: ["CA", "OR", "WA"] → West Coast
Postal Code Pattern	`matches` `does_not_match` `starts`	Starts With: "90" → Southern California
Zone	`in` `not_in`	In: "West Coast Zone" → Regional rate
Distance from Origin	`=` `≠` `>` `<` `≥` `≤` `between`	Distance ≤ 50 mi → Local delivery

Postal Code Patterns: Use wildcards (90*), ranges (90001-90099), or exact matches (90210). Distance: Set origin address in Settings. Uses great-circle calculation. Units: mi/km.

Time-Based Conditions

Condition	Configuration	Example Use Case
Date Range	Start date, End date	2025-11-25 to 11-29 → Black Friday
Days of Week	Select days (Mon-Sun)	Saturday, Sunday → Weekend processing
Time of Day	Start time, End time (24hr)	9:00-17:00 → Business hours only
Recurring Schedule	daily, weekly, monthly	Monthly on 1st → First of month special

Timezone: All times use your store's timezone setting.

Weight & Dimension Conditions

Condition	Operators	Example Use Case
Volumetric Weight	`=` `≠` `>` `<` `≥` `≤` `between`	Volumetric > 20 lb → Oversized fee
Package Dimensions	`=` `≠` `>` `<` `≥` `≤` `between`	Length > 48 in → Oversized surcharge

Volumetric Weight: (Length × Width × Height) ÷ Divisor (139 for inches, 5000 for cm). Used for large, lightweight items. Dimensions: Measure length, width, or height. Units: in/cm/ft/m.

Combining Conditions

AND Logic (all must match):

┌─ AND Group ──────────────┐
│ Cart Total ≥ $50         │
│ Country = "USA"          │
│ Collection = "Sale"      │
└──────────────────────────┘

OR Logic (any can match):

┌─ OR Group ───────────────┐
│ Customer Tag = "VIP"     │
│ Order Count ≥ 5          │
└──────────────────────────┘

Nested Groups: Combine AND/OR for complex rules like "Cart $100+ AND (VIP OR 10+ orders) AND USA (but not Alaska)"

Best Practices

Start Simple: Begin with 1-2 conditions, add more only if needed.

Choose Right Operators: Use Cart Total ≥ $50 (clear) instead of > $49.99 (confusing).

Test Boundaries: Always test edge cases like $49.99, $50.00, $50.01.

Group Related Logic: Use OR groups for related conditions (VIP tag OR 10+ orders OR $1000+ LTV) instead of separate rules.

Next Steps

Questions? Email support@ratetell.com

Condition Types

On this page