Additional shipping costs are extra charges added to the shipping rate as established in shipping policies. So, when configuring costs for shipping items, you can set a fixed rate and include additional charges. Together, these values will compose the shipping rate.
You can configure the following additional costs:
Note that all of them can be simultaneously considered for composing the shipping rate. The final calculation of the shipping rate is the sum of all additional charges plus the flat rate. The shipping rate is not the total shipping cost.
Weight-based additional shipping charge
This is the extra cost based on the package’s weight. The amount configured for this charge will be added to each unit of weight that exceeds the initial limit. So, for policies that contain a weight-based additional shipping charge, an extra fee will be charged for delivering packages whose weight exceeds the initial limit.
The additional amount is calculated by multiplying the weight-based charge configured in the shipping policy by the difference between the package’s weight and the initial weight limit.
Total weight-based charge = (product weight - initial weight limit) × (weight-based charge)
Example
For example, for a given shipping rate, the weight range accepted by the shipping policy is 300 g to 500 g (as you can see in the table below), the weight-based additional charge is US$ 0.10. This means that for every gram the package exceeds the initial limit of 300 g, the cost will be increased by US$ 0.10.
Consider a 350-g package with the following characteristics:
Flat rate: US$ 10.00
Additional insurance charge: US$ 0.00
Price-based additional charge: US$ 2.00
Weight-based additional charge: US$ 5.00
The calculation of the weight-based monetary value for delivering a 350-g package will be.
Additional shipping charge: 10%
Result:
Additional shipping charge: ($10 + $0 + $2 + $5) x 10% = $1.70
Additional shipping costs: ($2 + $5 + $1.70) = $8.70
Shipping rate: ($10 + $8.70) = $ 18.70
Configuration instructions
There are two ways to configure the weight-based additional charge:
- Using the shipping rate template: in the PriceByExtraWeight column.
- In the Shipping rates page: in the Additional value per weight field.
To learn more, access their tutorials.

Price-based additional charge
This is the extra cost based on the cart price. When you configure this charge, an extra cost proportional to the cart price will be added to the shipping rate.
Example
For example, a shipping policy that contains an additional charge of 5% based on the cart price. Suppose a cart's worth is US$ 180.00. The additional charge for delivering it will be US$ 9.00. This value will then be added to the shipping rate.
So the calculation will be as follows:
Flat rate: US$ 10.00
Additional insurance charge: US$ 0.00
Price-based additional charge: US$ 9.00
Weight-based additional charge: US$ 5.00
Additional shipping charge: 10%
Result:
Additional shipping charge: ($10+$0+$9+$5)x10%=$2,4
Additional shipping costs:($9+$5+$2,4)=$16,4
Shipping rate: ($10+$16,4)=$26,4
Note that the calculation of the price-based charge considers the cart's total price — without discounts and promotions. If the price-based charge is lower than the insurance charge, it will not be considered for the total shipping cost.
Configuration instructions
There are two ways to configure the price-based additional charge:
- Using the shipping rate template: in the PricePercent column.
- In the Shipping rates page: in the Additional value field.
To learn more, access their tutorials.
Additional insurance charge
This is the extra cost for shipping insurance. If you include it in your shipping policy, an absolute value will be added to the shipping rate.
Example
When you enter shipping policy costs for selected zip codes or polygons in the shipping rate template, if there is an insurance charge set to US$ 3.00, an amount of US$ 3.00 will be added to all deliveries to those locations.
Consider a package with the following characteristics:
Flat rate: US$ 15.00
Additional insurance charge: US$ 3.00
Weight-based additional charge: US$ 0.00
Weight-based additional charge: US$ 5.00
Additional shipping charge: 10%
Result:
Additional shipping charge: ($15 + $3 + $0 + $5) x 10% = $ 2.3
Additional shipping costs: ($3 + $5 + $2.3) = $ 10.3
Shipping rate: ($15 + $10.3) = $25.3
Configuration instructions
You can only configure the additional insurance charge via the shipping rate template in the MinimumValueInsurance field.
If the price-based charge is lower than the insurance charge, it will not be considered for the total shipping cost.
Additional shipping charge
This is the extra cost charged on the shipping rate. After considering all additional charges and the fixed rate, the shipping charge is calculated and refers to a percentage of the shipping rate.
This is the final charge to be calculated, according to the following formula:
Example
Consider a package with the following characteristics:
Flat rate: $ 15.00
Additional charges (weight, price, and insurance): $ 6.00
Additional shipping charge: 10%
The result would be:
Additional shipping charge: $2.10
Shipping rate: ($15 + $6) + ($2.10) = $23.10
Configuration instructions
To configure the additional shipping charge, go to the left-side menu in the VTEX Admin.
- In the VTEX Admin, go to Store settings > Shipping > Settings, or type Shipping in the search bar at the top of the page and select Store settings / Shipping.
- In the section Additional shipping rate, enter a value. If you want to include a 10% fee, fill in the field with 10. Use a period to indicate the decimal place, such as 1.67.
- Click on
Save
.
