China

PropertyValue
CodeCN
CurrencyCNY
RegionAsia, Eastern Asia
Name orderGiven name first
StateProvince, a list of 34
PostcodeRequired, checked, like 266033
RulesGET /v1/countries/CN

Form

The address form, in English. A field that is not required shows its optional label.

CountryChina First name Last name Address Apartment, suite, etc. (optional) City ProvinceChoose… Postal code266033 Phone number (optional)131 2345 6789

Fields

FieldLabelRequiredAutocomplete
countryCountry (list)yescountry
first_nameFirst nameyesgiven-name
last_nameLast nameyesfamily-name
line1Addressyesaddress-line1
line2Apartment, suite, etc.noaddress-line2
cityCityyesaddress-level2
stateProvince (list)yesaddress-level1
postcodePostal codeyespostal-code
phone_numberPhone numbernotel
emailEmailyesemail

Postcode

RuleValue
Requiredyes
Pattern^[0-9]{6}$
Example266033
Written asas typed
Checked by stateno

Phone

RuleValue
Calling code+86
National prefix0
Pattern^[0-9]{7,13}$
Example131 2345 6789
Written as### #### ####

Address format

How an address is written for reading, on an order page, a receipt or a label: address.format in the rules.

CODE
{postcode}
{state}{city}
{line1}
{line2}
{first_name} {last_name}
{country}

Written in Latin script, the lines differ:

CODE
{first_name} {last_name}
{line1}
{line2}
{city}
{state}, {postcode}
{country}

On an envelope, the province is written in capitals.

Example

A real address in China, from address.example, written with the format and the state by its name:

CODE
100006
Beijing Shi北京市
东城区东长安街16号
三 张
China

The same address in Latin script:

CODE
San Zhang
16 East Chang'an Avenue, Dongcheng District
Beijing
Beijing Shi, 100006
China

Province

The form submits the code, which is what an order stores; the name is what the shopper reads, in their language.

CodeName
Anhui ShengAnhui Sheng
Beijing ShiBeijing Shi
Chongqing ShiChongqing Shi
Fujian ShengFujian Sheng
Gansu ShengGansu Sheng
Guangdong ShengGuangdong Sheng
Guangxi Zhuangzu ZizhiquGuangxi Zhuangzu Zizhiqu
Guizhou ShengGuizhou Sheng
Hainan ShengHainan Sheng
Hebei ShengHebei Sheng
Heilongjiang ShengHeilongjiang Sheng
Henan ShengHenan Sheng
Hong Kong SARHong Kong SAR
Hubei ShengHubei Sheng
Hunan ShengHunan Sheng
Jiangsu ShengJiangsu Sheng
Jiangxi ShengJiangxi Sheng
Jilin ShengJilin Sheng
Liaoning ShengLiaoning Sheng
Macao SARMacao SAR
Nei Mongol ZizhiquNei Mongol Zizhiqu
Ningxia Huizu ZizhiquNingxia Huizu Zizhiqu
Qinghai ShengQinghai Sheng
Shaanxi ShengShaanxi Sheng
Shandong ShengShandong Sheng
Shanghai ShiShanghai Shi
Shanxi ShengShanxi Sheng
Sichuan ShengSichuan Sheng
Taiwan ShengTaiwan Sheng
Tianjin ShiTianjin Shi
Xinjiang Uygur ZizhiquXinjiang Uygur Zizhiqu
Xizang ZizhiquXizang Zizhiqu
Yunnan ShengYunnan Sheng
Zhejiang ShengZhejiang Sheng

Messages

What the form shows under a field when a value is refused, in English. Every language is on its page under Languages.

FieldErrorMessage
countrynot_selectedSelect a country
first_nameblankEnter a first name
first_nameinvalid_charactersFirst name can only contain letters, spaces, hyphens and apostrophes
first_namecontains_emojiFirst name can't contain emojis
first_nametoo_longFirst name must be 255 characters or fewer
last_nameblankEnter a last name
last_nameinvalid_charactersLast name can only contain letters, spaces, hyphens and apostrophes
last_namecontains_emojiLast name can't contain emojis
last_nametoo_longLast name must be 255 characters or fewer
line1blankEnter an address
line1contains_emojiAddress can't contain emojis
line1too_longAddress must be 255 characters or fewer
line2blankEnter address line 2
line2contains_emojiAddress line 2 can't contain emojis
line2too_longAddress line 2 must be 255 characters or fewer
cityblankEnter a city
cityinvalidEnter a valid city
citycontains_emojiCity can't contain emojis
citytoo_longCity must be 255 characters or fewer
statenot_selectedSelect a province
stateinvalidChoose a province from the list
postcodeblankEnter a postal code
postcodeinvalidEnter a valid postal code, like 266033
postcodecontains_emojiPostal code can't contain emojis
postcodetoo_longPostal code must be 64 characters or fewer
phone_numberblankEnter a phone number
phone_numberinvalidEnter a valid phone number, like 131 2345 6789
phone_numbercontains_emojiPhone number can't contain emojis
phone_numbertoo_longPhone number must be 24 characters or fewer
emailblankEnter an email address
emailinvalidEnter a valid email, like name@example.com
emailcontains_emojiEmail can't contain emojis
emailtoo_longEmail must be 254 characters or fewer