The following sub-regions within certain destination countries can be enabled or disabled on a product level. Merchants may also set differing shipping options (shipping prices and max delivery days) for these sub-regions. (Merchants based in Mainland China may learn more here; merchants based outside of Mainland China may learn more here.) The sub-region shipping price can be set to max 2 times the corresponding country's shipping price.
- French Guiana, FR
- French Polynesia, FR
- Guadeloupe, FR
- Martinique, FR
- Mayotte, FR
- New Caledonia, FR
- Reunion, FR
- Saint Martin, FR
- Saint Pierre & Miquelon, FR
- Wallis & Futuna, FR
- Canary Islands, ES
- AA, US
- AE, US
- Alaska, US
- American Samoa, US
- AP, US
- Hawaii, US
- Guam, US
- Northern Mariana Islands, US
Frequently Asked Questions
1. How do I enable or disable a given sub-region within a country?
The regions listed above can be enabled or disabled under a particular product’s Edit International Shipping Options page, as seen on the View All Products page under that particular product's "Country Shipping Price" column.
Specifically, click the link under the "Country Shipping Price" column in the row of your desired product.
On the Edit International Shipping Options page that follows, you will be able to click the button under the "Enable destination" column to enable or disable shipping for a certain sub-region within a destination country. Click Save Changes to save your settings.
A merchant is unable to ship to Alaska, US for a given product, but is still able to ship this product to other US states. Under the "Enable destination" column in the product’s Edit International Shipping Options page, the merchant can click the button ‘Off’ in the ‘Alaska’ row to disable this sub-region for the product:
Then merchant can select Save Changes in the top right of the page. Once the sub-region has been disabled, the merchant will not receive orders for Alaska, US. Please allow 24-48 hours for updates to reflect future orders.
Learn more about how to edit product shipping prices for different countries/regions.
2. Can I still ship to a given sub-region when the destination country as a whole is disabled?
If the destination country as a whole is disabled, all sub-regions will also be disabled. Orders will not be received for that given country.
3. Can I set shipping prices for certain sub-regions within a country?
Yes, shipping prices for sub-regions within a country are editable. The sub-region price can be set to max 2 times the country’s shipping price. (Merchants based in Mainland China may learn more here; merchants based outside of Mainland China may learn more here.)
4. Can I change the sub-region shipping price of a promoted product?
Yes, per the Merchant Policy, merchants may lower a product price and/or shipping price of an active promotion to offer users an even better deal. However, prices should not be increased as that may impact user perception, hurt conversion, and risk changing eligibility, which may open the product and promotion to rejection.
5. How do I update the sub-region shipping options via CSV?
Sub-region shipping options can be updated by going to the Merchant Dashboard Products > Add/Edit Products with CSV page.
Sub-region shipping can be edited the same as editing overall country shipping. To learn more on how to update shipping prices per product per destination via CSV file, check out this link here.
Similar to editing overall country shipping prices, you can specify ‘disabled’ or ‘enabled’ to determine whether customers in this sub-region can buy the product. You can also specify ‘use country shipping price’ to unset the sub-regional shipping.
To update the shipping price for a different sub-region, use their country code + ’_’ + region code defined here (example: US_HI).
Merchants may also edit max delivery days (a part of the shipping options on a product level, along with shipping prices) via CSV file. (Merchants based in Mainland China may learn more here; merchants based outside of Mainland China may learn more here.)
6. How do I update the sub-region shipping information via API?
Sub-region shipping prices can be edited in the following format, similar to when updating a country:
To learn more on what the sub-region codes are, check out this guide here.
Note that sub-region max delivery days currently cannot be set via API.
Example 1: Update shipping price to 2.99, and localized shipping to 2.99 for Reunion, FR for Standard products with the /product/update-shipping endpoint. The following parameters would be used along with the associated product id or parent_sku to successfully update.
country = FR_RE
price = 2.99
localized_price = 2.99
wish_express = false
use_country_shipping = false
Example 2: To enable the Wish Express US states: Arizona, and Hawaii, and disable Colorado using the /product/update-multi-shipping endpoint, the following parameters would be used along with the associated product id:
wish_express_add_countries = ‘US_AZ,US_HI’
Wish_express_disable_countries = ‘US_CO’
Example 3: Update shipping price to 4.99, and localized shipping to 4.99 for New South Wales, AU for Wish Express products with the /product/update-shipping endpoint. The following parameters would be used along with the associated product id or parent_sku to successfully update.
country = AU_NSW
price = 4.99
localized_price = 4.99
warehouse_name = Express-AU
use_country_shipping = false
Example 4: Update shipping price to 5.99, and localized shipping to 5.99 for shipping Wish Express to Sede Fortaleza & Sede Brasília, BR with the /product/update-shipping endpoint. The following parameters would be used along with the associated product id or parent_sku to successfully update.
country = BR_SFB
price = 5.99
localized_price = 5.99
warehouse_name = Express-BR
use_country_shipping = false