Settings - Freight

Freight modes

The following three freight modes are available:

  • Freight Free - Freight is free regardless of the destination content of the order.
  • Fixed Cost - Set a fixed freight cost regardless of the destination or content of the order.
  • Calculated Freight - The most commonly used freight setting and the subject of this documentation.

The ezimerchant freight system is based around the concept of packages. When buyers add items to the cart, ezimerchant simulates packing those items as optimally as possible into the available boxes. Once a set of boxes is available, a set of freight results is calculated using those boxes against each of the defined freight rules.


The ezimerchant freight system includes an advanced three-dimensional box packing algorithm, which takes the contents of the shopping cart and packs them into the most relevant box from the set of packages available.

The packing algorithm uses weights and dimensions to calculate the optimal set of packages, although dimensions are optional. If your products only have weights, only the weight limit of the package is taken into account.

By default the system is configured with the full set of packages available from your local Post office. Edit or delete these to suit your needs.

Define one or more package(s) to be used for freight calculation. Even though more packages results in less likelihood of wasted space when packing a set of items, there is a point of diminishing return. You may find it makes sense to only have 2 or 3 different package types in stock to achieve a near optimal result.

New Package

Click the New Package button to define a new package.

Package Type

The package type is used by some automated couriers as part of the quoting process.

Package Name

The package name is used only for display purposes to help you distinguish between packages in the package list.


The width of the package in centimetres. For elastic packages this represents the maximum width the package can grow to.


The length of the package in centimetres. For elastic packages this represents the maximum length the package can grow to.


The height of the package in centimetres. For elastic packages this represents the maximum height the package can grow to.

Weight Limit

The weight limit is the maximum total weight of items placed in the package before a new package is used.

Elastic Package

Elastic boxes make it easy to describe shipping costs. Think of it as wrapping the items in a shopping cart into a bundle. The bundle will have the smallest dimensions that fits all the items. Once we have the size of the box that fits your items, we'll get a quote from your shipping carrier. The dimensions you enter for an elastic box represent the maximum size it will grow to.


The carriers screen is where you can enable predefined services and define your own custom services.

The above image shows Australia Post carrier disabled And the Custom carrier enabled. Clicking the button toggles enabled status.

Clicking the carrier name opens the editor for that carrier.

Carrier Editor

The carrier editor shows a list of services available from the selected carrier.

Click the Enable button to toggle the enabled status of the service. When disabled the button is grey and has the text Enable. When enabled the button is green and has the text Enabled.

Clicking the edit icon to the left of the service name lets you edit the name of the service to the name you want displayed in the cart and checkout.


ezimerchant comes predefined with the set of regions specified by the postal service in your country.

New Freight Region

To define custom freight regions click the New Freight Region button and enter a name for the new region then click the Add Region button. The region will be added to the region list and can be edited in the same way as pre-existing regions.

Region Editor

Region Name

Countries Region

To define the countries region, tick one or more countries representing the region you are defining. For example if your courier service has rates to south-east Asia, you would tick all the countries defined by the courier as being in south-east Asia.

States Region

Select the country then from the list of states tick one or more states representing the region you are defining. For example, to create an Intrastate region you would select your own country and state.

City / Postal Code Region

This is the most flexible of the region types, Which make it possible to define a region as small as a single suburb or postal code or as large as an area spanning across multiple states.

Postcode ranges can be entered as comma separated ranges. For example 2000-2999,3000 is all NSW and ACT postcodes plus Melbourne.

Package Services Editor

Clicking the Carriers button on a package opens the Package Services Editor.

The editor shows a tab that each carrier already enabled against the package and a Add More Carriers link, which when clicked shows a list of other carriers enabled in the system but not on this package. It also has a Configure Carriers link which opens the same editor as described under Carrier Editor above.

Package Services

The list of services for the selected carrier is shown. Enable the services you want to support by clicking the Enable button. Enabled services have a green button with the text Enabled on it.

Service Pricing

Simple Pricing

Use Simple Pricing when there is no need for different rules are different regions. This is usually the case for automated freight services such as Australia Post because the service itself handles the calculation based on the source and destination.

Regional Pricing

Use Regional Pricing when there is a need to define different rules for different regions. When Regional Pricing is selected it shows the full list of regions. Enable or disable specific regions by clicking the button to the left of the region name. An enabled region has a grey button with a black icon and a disabled region has a red button with a white icon.

For regional pricing you will need to define the freight rule for each enabled region. The default is FreightCost, which is the value returned by automatic carriers such as Australia Post. FreightCost makes no sense for custom services because there is no automated calculation backing the value, so it will always result in $0.00. See freight expressions below for options.

Freight Expressions

When working out the freight cost for a particular package / service combination, ezimerchant executes the freight expression defined against that service within the package.

Expression Variables
  • FreightCost - the amount returned by the dynamic freight service (e.g. Australia Post). Does not apply to custom freight rules.
  • DeadWeight - the total weight of all cart items added together
  • CubicWeight - to cubic weight of all cart items added together at the rate of 250kg per cubic meter
  • Weight - the greater of DeadWeight and CubicWeight
  • SubTotal - the ex tax total of the cart
  • Total - the inc tax total of the cart
Expression Functions
  • Round - rounds numbers to the nearest whole number. If the fractional portion of the number is greater than or equal to 0.5 it is rounded up, otherwise it is rounded down.
  • Now - the current date
Example Expressions

The following are some example expressions which can be used in the freight price field.

Order Value based freight

The benefit of having a freight expression based on the order total is that you can apply different rules based on how much people order. The following example results in a price based on the total, but you can just as easily add the FreightCost variable into the result, which you may want to do if you want to surcharge calculated freight for small orders and discount it for larger ones.

(Total > 1000) ? 0 : (Total <= 1000 && Total > 500) ? 10 : 5

This expression uses a ternary operator for testing the Total and returning the appropriate result. Breaking this down:

[condition] ? [true result] : [false result]
  1. Our first condition is "Total > 100"
  2. If that condition is true the result is 0
  3. if that condition is false there is another condition "Total less than or equal to 1000 and Total greater than 500"
  4. if the second condition is true the result is 10 otherwise the result is 5

So the expression returns $0 for orders greater than $1000, $10 for orders between $500 and $1000 and $5 for orders under $500

Go Top