Often, you will need to have only certain kinds of inputs permitted for a specific form field – such as when users need to enter only an email address or phone number. In such cases, you can use validators to help users complete these kinds of form fields and to make them aware of any errors in their input.
Most validators will be available for the Input field form field type, where you can specify the format that users need to follow when inputting data into this field. The Password and File form fields also come with their own validators. Users will receive an error message if their input does not match the requirements set by these validators.
Email address
Email adress validation checks the accuracy of email addresses for you. Users will receive an error message if their input does not match the requirements set for a valid email address.
Error message If you need a different error message than the default error message wording, you can enter this error text for the Error message.
Date
If you activate the validation Date, a calendar is displayed when users click in the input field.
You can limit the entry of the date to a certain period of time. This is useful when a meeting can only be scheduled between two specific dates, for example.
If users enter text in the input field, it will not be accepted.
Error message If you need a different error message than the default error message wording, you can enter this error text for the Error message.
Date format Frequently used date formats are available here. The following elements are available here:
Element
Meaning
yyyy
Year, four digits
yy
Year, two digits
MM
Month, two digits
dd
Day, two digits
HH
Hour, two digits, 00 to 23
hh
Hour, two digits, 00 to 12
mm
Minute, two digits
Time restrictions
No time restrictions If you select No time restrictions, then your users will be able to enter any date.
Date range If users should enter a date that is within a specified period of time, then you can define this period using a Date range. Start date: Select the start date for your specified period of time. End date: Select the end date for your specified period of time.
Valid timespan You use Valid timespan to limit the date entered by the user to a maximum number of days before or after the form completion date. Days before completion date: The date entered must be within the period defined by the number of days before the completion date. Days after completion date: The date entered must be within the period defined by the number of days after the completion date.
Number
When you need your users to enter dimensions or quantities, you can use Number validation to ensure that the value entered by your users is in fact a number. You can also specify a number range: the user’s value must then be within this range. Users will receive an error message if they enter a number that is larger or smaller.
Error message If you need a different error message than the default error message wording, you can enter this error text for the Error message.
Min. value You use Min. value to specify the smallest possible value that users can enter into the form field. Users will receive an error message if they enter a number that is smaller.
Max. value You use Max. value to specify the largest possible value that users can enter into the form field. Users will receive an error message if they enter a number that is larger.
Integers only Select Integers only if you want to prevent users from entering decimal numbers.
Regular expression
You use a regular expression to confirm that a character string (i.e. the input from your users) complies with a specific format.
For example, your users may need to enter their customer number into an input field. Let’s assume that the customer number always consists of two uppercase letters, two lowercase letters and six digits, for example ABcd123456.
You can use a regular expression to define this format for the customer number. When users enter their customer number, this number is compared with the pattern specified by the regular expression. Users will receive an error message if the character string that they input does not consist of two uppercase letters, two lowercase letters and six digits.
Error message If you need a different error message than the default error message wording, you can enter this error text for the Error message.
RegEx If you want to specify a character string with a regular expression, enter this expression into the RegEx field. A list of regular expressions for use cases that are frequently needed – and which you can customise as required – is already provided here. The following regular expressions are available to you out of the box.
Regular expression
Explanation
Numbers: ^[0-9]*$
This regular expression allows only digits (0–9) to be entered.
3-7 numbers: ^[0-9]{3,7}$
This regular expression allows only three to seven digits (0–9) to be entered.
5 numbers: ^[0-9]{5}$
This regular expression allows only five digits (0–9) to be entered.
Phone: ^[+]{0,1}[0-9\s-/]*
This regular expression allows only a phone number to be entered.
Letters: ^[a-zA-ZÁ-ÿöäüÖÄÜß\s-]*$
This regular expression allows only letters to be entered.
3 lowercase letters: ^[a-z]{3}$
This regular expression allows only three lowercase letters to be entered.
Amount: ^[0-9]{1,7}(.\d{2})?$
This regular expression allows only a number containing 1 to 7 digits, with an optional two-digit decimal value following a decimal point.
Postcode validation checks user input against postcodes (or zip codes) for selected countries.
Error message If you need a different error message than the default error message wording, you can enter this error text for the Error message.
Country Use Country to select the country for which your users are supposed to be entering a postcode.
Country selection If you have added a drop-down list with a country selection to your form, then you can select the list here. The postcode must then come from the country that users select from that list. As one example, only German postcodes will be accepted if users select Germany from the country list.
Number of characters
With the Number of characters validation, you specify the minimum and maximum number of characters that users are allowed to enter into an input field.
Error message If you need a different error message than the default error message wording, you can enter this error text for the Error message.
Min. no. of characters Use Min. no. of characters to enter the minimum number of characters that users must enter into the input field. Users will receive an error message if they do not enter enough characters.
Max. no. of characters Use Max. no. of characters to enter the maximum number of characters that users can enter into the input field. Users will receive an error message if they enter too many characters.
IBAN
IBAN validation checks user input to confirm that it corresponds to the structure of an IBAN.
An IBAN always starts with a country code (e.g. ‘DE’ for Germany) and a 2-digit check number. This is followed by an 8-digit bank code and the account number (max. 10 digits). Account numbers that have fewer than 10 digits are padded with leading zeros.
Error message If you need a different error message than the default error message wording, you can enter this error text for the Error message.
Country Each country has its own IBAN format. If the IBAN needs to come from a specific country, use Country to select it. If you do not select a country, user input is checked only to confirm that it conforms to the basic IBAN structure.
Country selection If you have added a drop-down list with a country selection to your form, then you can select the list here. The IBAN must then come from the country that users select from that list. As one example, only a German IBAN will be accepted if users select Germany from the country list.
European Union VAT registration number
European Union VAT registration number validation checks user input to confirm that it corresponds to the structure of an EU VAT registration number. A European Union VAT registration number always starts with the 2-digit country code of the respective country, followed by nine to twelve digits, depending on the country. In some countries, the country code can be followed by letters as well as digits.
Error message If you need a different error message than the default error message wording, you can enter this error text for the Error message.
Country If the European Union VAT registration number needs to come from a specific country, use the country field to select it.
Country selection If the European Union VAT registration number should be checked against a country selected by users from somewhere else in the form, then you can link the validator to the corresponding form field. To do so, use Country selection to select the form field that provides the country selection from which users need to select a country. As one example, only a German EU VAT registration number will be accepted if users select Germany from the country list.
BIC
BIC validation checks user input to confirm that it corresponds to the structure of a BIC (Bank Identifier Code) – also known as a SWIFT code. A BIC always has the same structure: it consists of eight to eleven letters and digits that provide the sort code, country code, regional code and branch ID (optional).
Error message If you need a different error message than the default error message wording, you can enter this error text for the Error message.
Equal value
Equal value validation can be used to compare user input between two input fields and confirm that these values are identical. If the values are not the same, then users are notified of this fact and can then correct their input. This offers a reliable way to catch typos.
Another common usage is when asking users to enter their email address twice – which is often done when users register an account online. This ensures that the email address submitted by the user is valid and correct.
Error message If you need a different error message than the default error message wording, you can enter this error text for the Error message.
Compare with Use Compare with to select the second input field whose contents must match the input from this input field.
Phone number
Use Phone number validation to avoid incorrect user input when users are asked to enter telephone numbers. In addition, you can also specify that phone numbers must come from specific countries and/or require numbers to match certain types, such as fixed-line or mobile numbers.
Users will receive an error message if the phone number they enter has errors or does not meet your requirements.
Error message If you need a different error message than the default error message wording, you can enter this error text for the Error message.
Valid phone number types You can restrict the phone numbers that can be entered into this form field by number type. To do this, select a Phone number type.
Country Use Country to select the country for which your users are supposed to be entering a phone number. The validator then checks to confirm that the dialling code for the phone number entered matches the country code for the country specified.
Country selection If you have added a drop-down list or single choice form element with the data source 'country names' to your form, then you can select it here. The phone number must then come from the country that users select from that list. As one example, only phone numbers with a Spanish country code will be accepted if users select Spain from the country list.