# Set up table rates
URL: https://support.starshipit.com/articles/4414357709071-set-up-table-rates
Canonical: https://support.starshipit.com/articles/4414357709071-set-up-table-rates
Markdown: https://support.starshipit.com/articles/4414357709071-set-up-table-rates.md
Updated: 2026-06-15

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Step-by-step guide to setting up table rates.

## Set up table rates

Table rates for checkout and returns work in the same way. You can configure rates based on location and weight range.

## Table rates at checkout

For example, you are based in Sydney and want to offer a cheaper rate to customers in NSW. The item is large, so you still want the price to increase by weight.

| Location/Rate | 0 to 5kg | 5 to 10kg | 10 to 20kg |
| --- | --- | --- | --- |
| New South Wales | $5 | $10 | $15 |
| Rest of Australia | $20 | $25 | $30 |

1. Go to **Settings** > **Checkout Rates** > **Courier Configuration** > **Table Rates**.
2. Enter the mandatory **Product Code** and **Product Name**.
   * **Product Code** is an internal reference value for use with rules in Starshipit.
   * **Product Name** is displayed at checkout.
3. Under **Shipping Rates**, enter each rate as `Weight|Price`.

Example shipping rates:

| Value | Meaning |
| --- | --- |
| `5\|5` | Up to 5kg = $5.00 |
| `10\|10` | Over 5kg to 10kg = $10.00 |
| `20\|15` | Over 10kg to 20kg = $15.00 |

![Table rates configuration for checkout](/uploads/attachments/table-rates-checkout.png)

## Table rates for the Returns Portal

For example, you want to charge customers for the cost of shipping back a return. You offer both international and domestic returns, but international shipments cost 50% more in shipping.

| Location/Rate | 0 to 5kg | 5 to 10kg | 10 to 20kg |
| --- | --- | --- | --- |
| Australia | $5 | $10 | $15 |
| Rest of World | $7.50 | $15 | $22.50 |

This feature is available as part of the Returns Portal.

1. Go to **Settings** > **Returns** > **Return Charges**.
2. Select the return option you want the charge to apply to.
   * Return options are **Store Credit**, **Payment Refund**, and **Exchange Product**.
   * You can define different return costs for each return option, or use the same costs for all options.
3. Under **Return Charges**, enter each rate as `Weight|Price`.

Example return rates:

| Value | Meaning |
| --- | --- |
| `5\|5` | Up to 5kg = $5.00 |
| `10\|10` | Over 5kg to 10kg = $10.00 |
| `20\|15` | Over 10kg to 20kg = $15.00 |

![Table rates configuration for returns](/uploads/attachments/table-rates-returns.png)

## Table rates validation

### Country codes

The **Country Codes** field can be:

* empty, which applies to all country codes
* specific to a list of country codes, such as `AU, NZ`
* used to exclude a list of country codes, such as `!CA`

### State codes

The **State Codes** field can be:

* empty, which applies to all state codes
* specific to a list of state codes, such as `NSW, VIC`
* used to exclude a list of state codes, such as `!WA`

### Postcodes

The **Post Codes** field can be:

* empty, which applies to all postcodes
* specific to a list of postcodes, such as `2000` or `3000`
* specific to a list of postcode ranges, such as `2000-2999` or `3000-3999`
* used to exclude a list of postcodes, such as `!2000` or `!3000`
* used to exclude a list of postcode ranges, such as `!2000-2999` or `!3000-3999`

Use a standard hyphen (`-`) when entering postcode ranges. Do not use an en dash or em dash.

### Shipping rates

The **Shipping Rates** field is mandatory. Enter each rate as `Weight|Price`.

| Value | Meaning |
| --- | --- |
| `5\|6.50` | Up to 5kg = $6.50 |
| `10\|15.00` | Over 5kg to 10kg = $15.00 |
| `20\|22.00` | Over 10kg to 20kg = $22.00 |

## Bulk edit table rates

If your account has the **Bulk editor** option, you can edit many table-rate rows in a spreadsheet and paste them back into Starshipit.

1. Go to **Settings > Checkout Rates** and open the relevant carrier's table rates.
2. Turn on **Bulk editor**.
3. Select **Copy** and paste the rows into a spreadsheet.
4. Update the rows, keeping the columns in the same order.
5. Copy the edited rows from the spreadsheet and paste them into **Bulk editor**.
6. Save the carrier table rates.

The columns are: product code, product name, landed cost service, country codes, state codes, postcodes, suburbs, shipping rates, estimated transit time, display start time, and display end time.

:::important
The bulk editor expects tab-separated rows without a header row. Keep shipping rates in the `Weight|Price` format, such as `5|5` or `10|10`.
:::

## Upload a table rates CSV

Some accounts also have a **Table rates CSV** section in **Settings > Checkout Rates**. If it is available, use **Download CSV** to get the current file, edit a copy, then select **Upload CSV** to replace the account-level table rates.

Download the existing CSV before editing so its column order and carrier names stay valid. Deleting the CSV removes its table rates; carriers that only use that CSV return to contract rates.