Enable or Disable Regions Within a Destination

The following regions within destination countries can be enabled or disabled on a product level.

Merchants may also set different shipping options (i.e., shipping prices and max delivery days) for these regions. A region's shipping price can be set to max two times the corresponding country's shipping price.

• Merchants based in Mainland China: Learn more about customizing product-level shipping options
• Merchants based outside of Mainland China: Learn more about customizing product-level shipping options 

Canada:

• Alberta
• British Columbia
• Manitoba
• New Brunswick
• Newfoundland and Labrador
• Northwest Territories
• Nova Scotia
• Nunavut
• Ontario
• Prince Edward Island
• Quebec
• Saskatchewan
• Yukon

Chile:

• Antofagasta
• Arica y Parinacota
• Atacama
• Aysén del General Carlos Ibáñez del Campo
• Biobío
• Coquimbo
• La Araucanía
• Libertador General Bernardo O'Higgins
• Los Lagos
• Los Ríos
• Magallanes y de la Antártica Chilena
• Maule
• Metropolitana de Santiago
• Ñuble
• Tarapacá
• Valparaíso

Denmark:

• Bornholm
• Faroe Islands
• Greenland
• Samso

France:

• Corsica 
• French Guiana 
• French Polynesia 
• Guadeloupe 
• Martinique 
• Mayotte 
• New Caledonia 
• Reunion 
• Saint Martin 
• Saint Pierre & Miquelon 
• Wallis & Futuna 

Portugal:

• Azores
• Madeira

Mexico:

• Aguascalientes
• Baja California
• Baja California Sur
• Campeche
• Chiapas
• Chihuahua
• Coahuila
• Colima
• Distrito Federal
• Durango
• Guanajuato
• Guerrero
• Hidalgo
• Jalisco
• Michoacán
• Morelos
• México
• Nayarit
• Nuevo León
• Oaxaca
• Puebla
• Querétaro
• Quintana Roo
• San Luis Potosi
• Sinaloa
• Sonora
• Tabasco
• Tamaulipas
• Tlaxcala
• Veracruz
• Yucatán
• Zacatecas

Spain:

• Balearic Islands
• Canary Islands

United States:

• All 50 United States
• Armed Forces the Americas
• Armed Forces Europe
• Armed Forces Pacific
• American Samoa  
• Guam  
• Northern Mariana Islands 

Frequently Asked Questions

1. How do I enable or disable a given 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 can click the button under the "Enable destination" column to enable or disable shipping for a certain region within a destination country. Click Save Changes to save your settings.

Example:

A merchant is unable to ship to Alaska, U.S. for a given product, but is still able to ship this product to other U.S. 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 region for the product:

Then, the merchant can select Save Changes in the top right of the page. Once the region has been disabled, the merchant does not receive orders for Alaska, U.S. 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 region when the destination country as a whole is disabled?

If the destination country as a whole is disabled, all regions are disabled; orders are not received for that given country.

3. Can I set shipping prices for certain regions within a country?

Yes, shipping prices for regions within a country are editable. The region price can be set to max two 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 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 region shipping options via CSV?

Region shipping options can be updated by going to the Merchant Dashboard Products > Add/Edit Products with CSV page.

Region shipping can be edited the same as editing overall country shipping, and shipping prices can be updated via CSV file per product per destination.

Similar to editing overall country shipping prices, you can specify "disabled" or "enabled" to determine whether customers in this region can buy the product. You can also specify "use country shipping price" to unset the regional shipping.

To update the shipping price for a different region, use their country code + ’_’ + region code (e.g., US_HI), which can be found in the list of shipping countries/regions. 

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 region shipping information via API?

Region shipping prices can be edited in the following format, similar to when updating a country:

“CountryCode_RegionCode”

See the list of country/region codes.

Note that 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 /api/v3/products/{id} 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 U.S. states Arizona and Hawaii, and to disable Colorado using the /api/v3/products/{id} 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 /api/v3/products/{id} 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 /api/v3/products/{id} 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