Add new or edit country
Description
The purpose of this page is to add new or edit country.
QA
Common components
Bell icon (todo link)
Shop association block (todo link)
The UI elements
Country input
| Description | Value | Error message |
|---|---|---|
Mandatory | Yes | The field name is required at least in English (English). |
Allowed/Forbidden values | - | - |
Default value | - | - |
Help text | - | - |
Tool tips | Country name - Invalid characters: <>;=#{} | - |
Lower limit | 1 | - |
Upper limit | 64 | Your entry in field name (language English (English)) exceeds max length 64 chars (incl. HTML tags). |
Behavior | - |
ISO code input
| Description | Value | Error message |
|---|---|---|
Mandatory | Yes | The iso_code field is required. |
Allowed/Forbidden values | - | - |
Default value | - | - |
Help text | - | - |
Tool tips | Two --or three--letter ISO code (e.g. "us" for United States). | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Call prefix input
| Description | Value | Error message |
|---|---|---|
Mandatory | Yes | - |
Allowed/Forbidden values | Numbers allowed only | The call_prefix field is invalid. |
Default value | - | - |
Help text | - | - |
Tool tips | International call prefix, (e.g. 1 for United States). | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Default currency dropdown
| Description | Value | Error message |
|---|---|---|
Mandatory | Yes | - |
Allowed/Forbidden values | - | - |
Default value | Default store currency | - |
Help text | - | - |
Tool tips | - | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Zone dropdown
| Description | Value | Error message |
|---|---|---|
Mandatory | Yes | - |
Allowed/Forbidden values | - | - |
Default value | Africa | - |
Help text | - | - |
Tool tips | Geographical region. | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Does it need Zip/Postal code? toggle switch
| Description | Value | Error message |
|---|---|---|
Mandatory | Yes | - |
Allowed/Forbidden values | - | - |
Default value | No | - |
Help text | - | - |
Tool tips | - | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Zip/Postal code format input
| Description | Value | Error message |
|---|---|---|
Mandatory | Yes | - |
Allowed/Forbidden values | N, L, C letters allowed only | The zip_code_format field is invalid. |
Default value | - | - |
Help text | Indicate the format of the postal code: use L for a letter, N for a number, and C for the country's ISO 3166-1 alpha-2 code. For example, NNNNN for the United States, France, Poland and many other; LNNNNLLL for Argentina, etc. If you do not want PrestaShop to verify the postal code for this country, leave it blank. | - |
Tool tips | - | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Address format input
| Description | Value | Error message |
|---|---|---|
Mandatory | No | - |
Allowed/Forbidden values | - | - |
Default value | firstname lastname company vat_number address1 address2 postcode city Country:name phone | - |
Help text | Some countries require different elements than others. Click on the button below to get the valid default address format for this country. | - |
Tool tips | - | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Use the last registered format button
| Description | Value | Error message |
|---|---|---|
Mandatory | No | - |
Allowed/Forbidden values | - | - |
Default value | - | - |
Help text | - | - |
Tool tips | This will restore your last registered address format. | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Use the default format button
| Description | Value | Error message |
|---|---|---|
Mandatory | No | - |
Allowed/Forbidden values | - | - |
Default value | - | - |
Help text | - | - |
Tool tips | This will restore the default address format for this country. | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Use my current modified format button
| Description | Value | Error message |
|---|---|---|
Mandatory | No | - |
Allowed/Forbidden values | - | - |
Default value | - | - |
Help text | - | - |
Tool tips | This will restore your current address format. | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Clear format button
| Description | Value | Error message |
|---|---|---|
Mandatory | No | - |
Allowed/Forbidden values | - | - |
Default value | - | - |
Help text | - | - |
Tool tips | This will delete the current address format. | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Active toggle switch
| Description | Value | Error message |
|---|---|---|
Mandatory | Yes | - |
Allowed/Forbidden values | - | - |
Default value | Yes | - |
Help text | - | - |
Tool tips | Display this country to your customers (the selected country will always be displayed in the Back Office.) | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Contains states toggle switch
| Description | Value | Error message |
|---|---|---|
Mandatory | Yes | - |
Allowed/Forbidden values | - | - |
Default value | No | - |
Help text | - | - |
Tool tips | - | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Do you need a tax identification number? toggle switch
| Description | Value | Error message |
|---|---|---|
Mandatory | Yes | - |
Allowed/Forbidden values | - | - |
Default value | No | - |
Help text | - | - |
Tool tips | - | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Display tax label (e.g. "Tax incl.") toggle switch
| Description | Value | Error message |
|---|---|---|
Mandatory | Yes | - |
Allowed/Forbidden values | - | - |
Default value | Yes | - |
Help text | - | - |
Tool tips | - | - |
Lower limit | - | - |
Upper limit | - | - |
Behavior | - |
Behaviors description
Title of Countries behavior
Countries is the title of new country addition block, it has title and world icon.
Country input behavior
This is input field (Forms normal UI kit) to enter country name.
ISO code input behavior
This is input field (Forms normal UI kit) to enter country ISO code. When try to add a country with an already existing ISO, the following error will show: This ISO code already exists. You cannot create two countries with the same ISO code.
Call prefix input behavior
This is input field (Forms normal UI kit) to enter call prefix number.
Default currency dropdown
This is dropdown (Dropdowns basics UI kit) that allows to select a currency from the ones that are enabled on the shop for this country.
Zone dropdown behavior
This is dropdown (Dropdowns basics UI kit) that allows selecting a zone. All the zones are listed in alphabetical order (both enabled and disabled ones).
Does it need Zip/Postal code? toggle switch behavior
This is toggle switch (Forms switch story UI kit) that allows to choose whether a user living in this country must give a zip code or not when signing up to the shop.
Zip/Postal code format input behavior
This is input field (Forms normal UI kit) to enter zip/postal code format.
Address format input behavior
This is input box is displayed with the following default inputs. Under the help text, there are the 5 following helper tabs, once clicked its elements are displayed and can be selected. When hover mouse pointer on tab, tab becomes outlined and text color changes. These tabs are:
Customer - it is opened by default. The following parameters can be added to the address format: lastname, firstname, birthday, email, website, company, siret, reset_password_token, htmlFields.
Warehouse - the following parameters can be added to the address format: reference, name, management_type, htmlFields.
Country - the following parameters can be added to the address format: iso_code, name, zip_code_format, htmlFields.
State - the following parameters can be added to the address format: iso_code, name, htmlFields.
Address - the following parameters can be added to the address format: company, lastname, firstname, address1, address2, postcode, city, other, phone, phone_mobile, vat_number, dni, htmlFields.
There are errors notifications that can be created in Address format input:
This key has already been used.: company - when used more than one time.
This property does not exist in the class or is forbidden.: Address: phonec -when entered with grammatical error
This name is not allowed.: phonec - when entered with grammatical error
The firstname field (in tab Address) is required. - when required field is not entered.
Use the last registered format button behavior
This is outlined CTA button (Buttons outline UI kit), when hover mouse pointer on it, buttons color changes. Once clicked opens modal with question: Are you sure you want to restore the default address format for this country? There are also two buttons:
OK - blue CTA button (Buttons basics UI kit), once clicked will input the address format box with the last registered formats and close modal.
Cancel - white outlined CTA button (Buttons outline UI kit), once clicked will cancel address format restoring and close modal.
Use the default format button behavior
This is outlined CTA button (Buttons outline UI kit), when hover mouse pointer on it, buttons color changes. Once clicked opens modal with question: Are you sure you want to restore the default address format for this country? There are also two buttons:
OK - blue CTA button (Buttons basics UI kit), once clicked will input the address format box with the last registered formats and close modal.
Cancel - white outlined CTA button (Buttons outline UI kit), once clicked will cancel address format restoring and close modal.
Use my current modified format button behavior
This is outlined CTA button (Buttons outline UI kit), when hover mouse pointer on it, buttons color changes. Once clicked will restore current address format.
Clear format button behavior
This is outlined CTA button (Buttons outline UI kit), when hover mouse pointer on it, buttons color changes. Once clicked opens modal with question: Are you sure you want to restore the default address format for this country? There are also two buttons:
OK - blue CTA button (Buttons basics UI kit), once clicked will delete all elements from the address format box and close modal.
Cancel - white outlined CTA button (Buttons outline UI kit), once clicked will cancel address format clearing and close modal.
Active toggle switch behavior
This is toggle switch (Forms switch story UI kit) that allows to enable or disable country.
Contains states toggle switch
This is toggle switch (Forms switch story UI kit) that allows to select whether the country has states or not.
Do you need a tax identification number? toggle switch behavior
This is toggle switch (Forms switch story UI kit) that allows to select whether the tax identification number is needed or not.
Display tax label (e.g. "Tax incl.") toggle switch behavior
This is toggle switch (Forms switch story UI kit) that allows choosing whether the tax status (included or excluded) should be displayed next to the prices or not.
Multistores functionality
Multistores independent page. Multistore functionality depends on Shop association block settings. The shop association block is displayed when the multistore is enabled and if several shops are configured.
Last updated
