Skip to content
Transdirect Developer Centre

Rules engine

The rules engine lets you add conditions to your shipping quotes. You can control which couriers appear, adjust pricing, or offer free shipping based on a wide range of triggers.

Rules are managed under WooCommerce → Settings → Shipping → Transdirect Shipping → Rules.

Rule types

Section titled “Rule types”

Each rule starts by selecting a type, which determines what condition is evaluated.

Postcode

Match against the customer’s delivery postcode. You can enter a single postcode, a comma-separated list, or a range (e.g. 2000-2099).

Useful for restricting or adjusting quotes for specific delivery areas.

State

Match against the customer’s delivery state. Select one or more from:

ACT, NSW, NT, QLD, SA, TAS, VIC, WA

Useful for state-based shipping promotions or restrictions.

Weight

Match against the total weight of items in the cart. Choose a condition — equals, less than, greater than, less than or equal, greater than or equal — and set a weight value in kilograms.

Useful for applying surcharges to heavy orders or offering free shipping on light parcels.

Cost

Match against the total cart value. Choose a condition and set a dollar amount. Actions can include:

  • Fixed amount — Set shipping to a specific dollar value.
  • Free shipping — Remove the shipping cost entirely.
  • Additional fee — Add an extra charge on top of the quoted price.

Useful for “free shipping over $100” promotions or minimum shipping charges.

Product SKU

Match against a specific product by its SKU. When the matching product is in the cart, the rule triggers.

Useful for products that require special handling, oversized surcharges, or courier restrictions.

Quantity

Match against the total number of items in the cart. Choose a condition and set a quantity value.

Useful for bulk order discounts or surcharges when item count exceeds a threshold.

Couriers column

Section titled “Couriers column”

Each rule has a Couriers column where you can tick specific couriers for the rule to apply to.

  • If you select specific couriers, the rule only affects quotes from those couriers.
  • If you leave all couriers unchecked, the rule applies to all couriers.

Priority

Section titled “Priority”

When multiple rules share the same type and trigger, they execute in priority order. You can adjust priority using the up and down arrows next to each rule.

Rules with higher priority (lower number) execute first. This matters when rules have overlapping conditions — the priority determines which rule takes precedence.

Creating a rule

Section titled “Creating a rule”

Each rule is built from three sections:

  1. Rule Type

    Select the type of condition to evaluate: Postcode, State, Weight, Cost, Product SKU, or Quantity.

  2. Trigger

    Define the specific condition that activates the rule. For example, a postcode range, a weight threshold, or a cart value.

  3. Action

    Choose what happens when the rule triggers. Actions vary by rule type and can include applying a surcharge, setting a fixed price, enabling free shipping, or restricting couriers.

Single rule vs multiple rules

Section titled “Single rule vs multiple rules”
  • A single rule applies one condition and one action. For example: “Free shipping to NSW when cart is over $150.”
  • Multiple rules can be combined to create layered logic. For example: one rule offers free shipping over $150, while another adds a $10 surcharge for postcodes in remote areas. Both rules evaluate independently, and priority determines execution order when they overlap.

Import bulk rules

Section titled “Import bulk rules”

If you have a large number of rules to create, you can upload them in bulk using a CSV file.

Click Import Bulk Rules in the rules section and upload your CSV. The file should follow the expected column format for rule type, trigger values, actions, and courier selections.