Version 2019-10

The Province resource represents the sales tax that's applied to orders from the sub-regions of a country. It represents any type of sub-region, such as states, provinces, territories, and counties.

You can use the Province resource to retrieve and update available provinces for only the countries that a shop owner has added to a shipping zone. Merchants add countries to a shipping zone from the Shipping page of their Shopify admin.

For information on accessing the tax information for an entire country, including its provinces, see the Country resource.


As of version 2020-10, you can no longer update custom tax values for the Province resource.

Countries that have provinces in Shopify

Shopify provides provincial tax rates for the following countries:

Argentina (24 provinces) Malaysia (16 states/territories)
Australia (8 states/territories) Mexico (32 states)
Brazil (27 states) New Zealand (16 regions)
Canada (13 provinces/territories) Nigeria (37 states)
China (31 provinces) Panama (13 regions)
Colombia (33 provinces) Portugal (20 regions)
Egypt (29 governorates) Romania (42 counties)
Guatemala (22 regions) Russia (82 regions)
India (36 states) South Africa (9 provinces)
Indonesia (34 provinces) South Korea (17 provinces)
Ireland (26 counties) Spain (52 provinces)
Italy (110 provinces) United Arab Emirates (7 emirates)
Japan (47 prefectures) United States (62 states/territories)

What you can do with Province

The Shopify API lets you do the following with the Province resource. More detailed versions of these general actions may be available:

Province properties

"code": "AB"

The standard abbreviation for the province.

"country_id": 879921427

The ID for the country that the province belongs to.

"id": 205434194

The ID for the province.

"name": "Alberta"

The full name of the province.