comecerodocs
Settings reference

Shipping adjustments

Change a shipping method's price for some US states or Canadian provinces, such as Alaska and Hawaii, by a percentage or a fixed amount per currency.

An adjustment changes a shipping method's price for some states or provinces. Use it when shipping to a place costs more, such as Alaska or Hawaii, or less, such as a state close to your warehouse. Adjustments work only for the United States and Canada.

Add them to the shipping method in the dashboard under Store > Shipping Methods, or with adjustments in Create a shipping method or Update a shipping method.

How an adjustment works

Each adjustment has a country (US or CA, and one of the method's countries), the regions it covers (state or province codes such as AK and HI), and either a percentage or fixed amounts, not both.

  • percentage: a fraction of the price. 0.15 adds 15%, -0.2 takes off 20%. From -1 (-100%) to 5 (500%).
  • amounts: a fixed amount added to the price, one per currency. A negative amount lowers the price. When the shopper's currency is not listed, the first amount is converted.
{
  "adjustments": [
    { "country": "US", "regions": ["AK", "HI"], "percentage": 0.15 },
    { "country": "US", "regions": ["WA", "OR"], "amounts": [{ "price": -2, "currency": "USD" }] }
  ]
}

Here Alaska and Hawaii pay 15% more, and Washington and Oregon pay $2 less.

A region may appear in only one adjustment of a method. The adjustment is applied to the price that the method's quantity, subtotal or weight rules give, after it is converted to the shopper's currency. If the result is below 0, the price is 0.

On this page