Configuration Overview
The Webkul Mage Table Rate carrier engine provides a robust calculation system that matches incoming checkout conditions against defined shipping matrices.
How the Rate Engine Evaluates Shipping
When a customer enters their delivery address during checkout or cart estimation, the carrier calculates matching rules through a sequential filter:
Calculation Factors
Merchants can configure the carrier to evaluate rates based on multiple concurrent criteria:
Geographic Boundaries
- Country: Matches the customer's 2-letter ISO country code (
US,CA,GB,IN, etc.). - Region / State: Matches region ID, state code, region name, or wildcard
*. - Numeric Zip Code Range: Compares numeric postal codes between
zipandzip_to. - Alphanumeric Postal Code: Matches exact or prefix postal patterns (e.g. UK
EC1A, CanadaH3Z).
- Country: Matches the customer's 2-letter ISO country code (
Cart Measurements
- Cart Subtotal: Evaluates order value against
price_fromandprice_to. - Package Weight: Evaluates total quote weight against
weight_fromandweight_to. - Item Quantity: Evaluates total quantity of items in cart against
quantity_fromandquantity_to.
- Cart Subtotal: Evaluates order value against
Customer & Store Context
- Customer Group: Targets specific customer groups (e.g., General, Wholesale, VIP, or all via
*). - Store View: Restricts specific rules to specific store views (or all via
0or*). - Rule Status: Enables or disables individual rules dynamically.
- Customer Group: Targets specific customer groups (e.g., General, Wholesale, VIP, or all via
Documentation Sections
- Carrier Settings: Configure global carrier activation, frontend title, applicable countries, and calculation basis.
- Table Rate Rules & CSV Import: Manage shipping rules, download sample CSVs, bulk import rates, and edit individual rows.
- Storefront & Checkout: Understand how customers interact with calculated rates during checkout.
- GraphQL API: Manage shipping methods programmatically in headless and mobile architectures.
Next Step
Configure global carrier options in Carrier Settings.
