Skip to main content

Input Phone Node

The InputPhoneNode provides an input field for users to enter their phone number. It includes a dropdown for selecting a country code, ensuring the phone number is formatted and validated according to the selected country's standards. This node is useful for collecting accurate and standardized phone number data.

Use Case​

Use the InputPhoneNode when you need to collect phone number from the customer.

UI Examples​

Node in TellUs

Behavior​

  • Blocking: The node waits for the user to type and submit a response
  • Produces output: Stores the input in combined output variable displayValue, containing country code extension and phone number
  • Renders: dropdown, combined with input field
  • Supports validation: Can be marked as required/optional and constrained by regex pattern. Phone number format validation is performed both - on frontend and backend.
  • Moves to the next node after user submission

Node Metadata​

PropertyDescription
Node classInputPhoneNode
MessageType40
CanBeEditedTrue
CanBeProcessedOnceFalse
RequireUserResponseYes

Input Properties​

PropertyDescription
defaultCountry

Defines pre-selected country code. Allowed values allways appear on top of the country code list.

  • Allowed Values:
      • SE
      • NO
      • FI
      • DK
maxLengthValidationMessage

Used only if additional Length validation is set. Should be left empty most cases, as phone number format validation covers everything.

  • Default Values:
      • En:Text length exceeds allowed
      • No:Teksten er for lang
      • Dk:Teksten er for lang
      • Fi:Liian pitkä teksti
      • Se:Värdet är för långt.
inputSize

TODO: Add description.

  • 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:Invalid phone number format
      • No:Telefonnummeret er feil
      • Dk:Indtast et rigtigt telefonnummer
      • Fi:Virheellinen puhelinnumeron muoto
      • Se:Vänligen kontrollera på telefonnumret
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
displayValue

Combined country code extension and phone number. For example - +37122222222.

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.

Editor example content