Country Select
A searchable dropdown for selecting a country, with optional flag display and region code.
The Country Select field renders a dropdown populated with all world countries. Users can search by typing to quickly find their country. The field supports flag emoji display and optional region code output.
For the shared properties available on all fields (label, help, note, key, width, visual styling, required), see the Form Fields Overview.
Configuration
| Property | Type | Default | Description |
|---|---|---|---|
| placeholder | string | "Select country" | Ghost text shown when no country is selected |
| showFlag | boolean | true | Whether to display the country flag emoji next to each option |
| withRegionCode | boolean | false | When true, includes the ISO region code (e.g. "US", "GB") alongside the country name in the stored value |
Validation
The Country Select field extends InputFieldBase, so the required toggle is available. When required, the user must pick a country before the form can be submitted.
Example Usage
A shipping form that captures country with region code:
{
"type": "countrySelect",
"label": "Country",
"required": true,
"placeholder": "Select your country",
"showFlag": true,
"withRegionCode": true
}