Skip to main content

Country Node

The Country node displays a filtered list of countries based on the letter typed by the user and allows them to select a country. When a country is selected, both the country code and name are saved for use in subsequent nodes.

warning

Node is only available for Web Chat use

Use Case​

Use the Country node when you want to:

  • Allow the user to select a travel destination country in a quick and intuitive way.
  • Filter the list of countries based on the first letter the user types to narrow down options.
  • Capture the country code and country name for use in travel claim or policy inquiry flows.

Don't use it when:

  • You need to allow free text input of country names; this node requires letter-based selection.
  • The country information is already known and available in the flow; skip this node if the value is predetermined.
  • You need to select multiple countries at once; this node allows single country selection.

UI Examples​

Not applicable

Behavior​

Behavioral characteristics

  • Blocking node: The flow pauses and waits for the user to select a country.
  • User input required: The user must enter at least one letter to filter the country list, then select a country from the filtered results.
  • No default value: If no country is selected, the flow cannot proceed.
  • Output values: When a country is selected, the node saves two values:
    • countryCode — The ISO 3166-1 alpha-2 country code (for example, "ES" for Spain, "IT" for Italy).
    • countryName — The full country name (for example, "Spain", "Italy").
  • Validation: The node requires a valid country selection; the flow will not advance until a country is chosen.

Node Metadata​

PropertyDescription
Node classCountryNode
MessageType123
CanBeEditedTrue
CanBeProcessedOnceFalse
RequireUserResponseYes

Input Properties​

PropertyDescription
inputPlaceholder

Placeholder text displayed in the input field to guide the user (for example, 'Type country name or letter').

  • Default Values:
      • En:Enter country...
      • No:Oppgi land...
      • Dk:Indtast land...
      • Fi:Kirjoita ja valitse vahinkomaa...
      • Se:Ange land...
noResultsFoundMessage

Message displayed when the user's letter input matches no countries (for example, 'No countries found').

  • Default Values:
      • En:No results found.
      • No:Ingen resultater funnet.
      • Dk:Der er ikke fundet noget resultat.
      • Fi:Tuloksia ei löydy.
      • Se:Ingen träff.
allowAnyValue

When enabled, the country list includes all countries available; when disabled, only predefined travel destinations are shown.

  • Default Values:
      • En:false
  • Allowed Values:
      • true
      • false
inputSize

The width of the input field; adjusts the visual size of the control on the screen.

  • Default Values:
      • En:medium
  • Allowed Values:
      • medium
      • large
defaultValidationMessage

The default error message shown when the input is invalid or missing. This is used if no custom validation message is provided.

  • Default Values:
      • En:Please type in value
      • No:Skriv noe
      • Dk:Indtast værdi
      • Fi:Kirjoita kenttään
      • Se:Ange värde
sectionId

Groups this node visually under a specific section in TellUs. When multiple nodes share the same sectionId, they are displayed together under a shared header.

defaultValue

The initial value that is prefilled into the input field when the node is rendered. Useful for suggesting defaults or pre-populating known data.

isRequired

Determines whether the user must provide a value before continuing. If set to true, the form will not proceed without input.

  • Default Values:
      • En:true
  • Allowed Values:
      • true
      • false
isRequiredValidationMessage

The error message shown when a required field is left empty. This overrides the default validation message when isRequired is true.

  • Default Values:
      • En:Value is required
      • No:Verdi er påkrevd
      • Dk:Værdi er påkrævet
      • Fi:Arvo vaaditaan
      • Se:Värde krävs

Output Properties​

PropertyDescription
code

The ISO 3166-1 alpha-2 country code of the selected country (for example, 'ES' for Spain, 'IT' for Italy).

text

The full name of the selected country (for example, 'Spain', 'Italy', 'France').

Editor Example​

Try it in the Atlas Editor

This link opens a prebuilt flow using this node in context. You can inspect how it's configured, how it's connected, and how it behaves in a real editor environment.

Node in TellUs