How to set Additional Item shipping price

Additional Item shipping price allows merchants to offer discounted shipping to customers who purchase multiple quantities of the same product in a single order. This is a separate, lower shipping price that applies to all products after the first product.

For example, the shipping price is set to $5 for one product, and the Additional Item shipping price is set to $1. This means the shipping price for two of this product will be $6 [$5 + $1], and the shipping price for three of this product will be $7 [$5 + $1 + $1]. 

Merchants can set the Additional Item shipping price via Merchant Dashboard, CSV, or API. See below for details.

Merchant Dashboard

1). Navigate to Products > View All Products.

2). Click View in the row of the desired product, under the Country Shipping Price column.

3). On the Edit International Shipping Options page, enter the Additional Item shipping price in the Additional Item field, and click the Save Changes button.

CSV

1). When editing shipping prices via CSV, add a new column in the CSV file with a title in the following format: 

[Country/Region Code] Additional

For example, if a merchant is setting Additional Item shipping price for a Canada-bound product, this new column would be titled CA Additional.

Note: A full list of CSV country/region codes is available in our List of Shipping Countries / Regions article. 

2). Set the Additional Item shipping price under this column, in the row of the relevant product. For example, if a merchant wants to set the Additional Item shipping price for a Canada-bound product to $1, they would enter 1 under the CA Additional column.

3). Select Edit shipping from the Action type dropdown in Product > Add/Edit Product with CSV, and proceed with CSV upload.

Note: Merchants can only set Additional Item shipping price via CSV when editing shipping. Additional Item shipping price cannot be set via CSV when adding products, editing products, or adding variations.

API

Merchants can set Additional Item shipping price when adding or editing products via the new “additional_price” field. This field has has been added to the “CountryShippingDetail” and “RegionShippingDetail” objects in our v3 API, available in the following Products and Product Job endpoints:

• Products:
• POST /api/v3/product
• PUT /api/v3/product/{id}
• GET /api/v3/product
• GET /api/v3/product/{id}

• Product Job:
• POST /api/v3/products/bulk_get
• POST /api/v3/products/bulk_update

Frequently asked questions

1. Does Additional Item shipping price apply when a customer buys different products?

No, Additional Item shipping price currently only applies to multiple quantities of the same product. If a customer purchases two different products, shipping will be charged separately.

2. Can Additional Item shipping price be higher than the primary shipping price?

No, the Additional Item shipping price must be the same or less than the primary shipping price for the given destination.

3. How does Additional Item shipping price affect refunds?

Shipping is evenly distributed to each product for refunds. If a customer refunds all quantities of a product, the entire shipping fee is refunded. If a customer refunds partial quantities of a product, the shipping amount evenly attributed to those quantities is refunded.

For example, a merchant sets shipping price to $5 and Additional Item shipping price to $1. A customer buys two of the same product, and pays $6 for shipping. If the customer refunds only one of this product, they will be refunded $3 for shipping. If the customer refunds both products, they will be refunded the total $6 for shipping. 

4. What if Additional Item shipping price is not set?

If a merchant does not set an Additional Item shipping price, shipping price will increase linearly by default. For example, the shipping price is $5 for one product. If Additional Item shipping price is not set, the shipping price for two of this product will be $10 [$5 + $5], and the shipping price for three of this product will be $15 [$5 + $5 + $5].

5. After setting the Additional Item shipping price, how long does it take to go live to customers?

Additional Item shipping price will reflect live to customers immediately after being set.