Email

Validation of email addresses

The Nintex email control validates emails that are entered in a form. While most valid emails are allowed, validation is performed to identify invalid email formats and common syntax errors.

The accepted format of an email address is prefix@domain. The prefix and domain parts must be in acceptable format for email addresses to be accepted as valid.

Prefix is the part of the email address that comes before the @ symbol. The prefix can have a maximum of 64 of the following characters:

Uppercase and lowercase letters a-z.
Digits 0 to 9.
Characters other than the letters and digits !#$%&'*+-/=?^_`{|}~
Dot (.) - if it is not the first or last character unless it is included within quotes.

Domain is the part of the email address that comes after the @ symbol and can have a maximum of 255 of the following characters:

Uppercase and lowercase a-z.
Digits 0 to 9, provided that they are not all-numeric.
Hyphen (-) - provided that it is not the first or last character.

Some examples of addresses considered as valid and invalid by Nintex email validation are shown in the tables below.

Valid email addresses

The following table shows examples of valid emails.

Valid emails	Description
user.name@example.com	Contains acceptable characters.
example@com.uk	Contains a valid domain.
admin@mailserver1	Contains the name of a local domain. The format is acceptable but it is highly recommended that you enter the complete syntax of your local domain.
name@[123.123.123.123]	Contains the IP address of a domain.

Invalid email addresses

The following table shows examples of invalid emails.

Invalid emails	Description
Abc.example.com	Contains no @ character.
A@b@c@example.com	Contains more than one @ character before the domain name.
a"b(c)d,e:f;g<h>i[j\k]l@example.com	Contains invalid characters before the domain name .
just"not"right@example.com	Contains strings within quotes. Quoted strings are allowed only if dot separated or if it the only element before the domain name.
this is"not\allowed@example.com	Contains spaces, quotes and backslashes before the domain name. They are allowed only if included within quoted strings and preceded by a backslash.
1234567890123456789012345678901234567890123456789012345678901234+x@example.com	Contains more than 64 characters before the domain name.

The Email form control allows users to enter an email address into a form field.

Note: You can arrange up to six of this control on a single row in the form.

Section	Setting	Description
(unlabeled)	Title	The name of the field that is displayed on the published form.
	Customize	Switch toggle to Yes to enable customization of the variable Name of the form control.
	Name	(This field becomes configurable only when you switch the Customize toggle to Yes.) Customizes the name of the variable A placeholder that stores changes each time the workflow runs, such as the information entered in a form, or the name of a file. You can also create variables to store information you use in the workflow, such as an email address. for the field. If the name is not customized, the Title will be used as the variable name.
	Connected to	Connect to a SharePoint column. Only SharePoint columns of the same type as the selected control are available in the drop-down list. When connected, data entered via that field in the form is entered in the selected SharePoint column. What is a SharePoint column? When you open Nintex Forms for a new SharePoint list, the form designer automatically creates form fields for the equivalent SharePoint columns in your list. The SharePoint columns are displayed in the designer when you open it. If you want to delete them from or add them to your form, you can do so under the SharePoint Columns controls.
	Default value	The value which automatically populates the field when the form loads. Click in this field, and then click Insert to launch the Formula builder where you can create variables with applied formulas. The calculated value becomes the default value.
	Required	Mandates entry of a value before the form can be submitted.
	Custom required message	(Displays when you select Yes in Required) The validation text which displays below the field when a value is not entered into the field and the user attempts to change page or submit the form.
	Visible	Shows the field on the published form when loaded.
	Read-only	Displays the field on the published form but does not allow user input.
	Placeholder	Default text displayed in the field on the published form. This default text disappears when the user types the first valid character inside the field.
	Description	A description of the field to display below the field on the published form.
	Tooltip	The message which appears when users hover their cursor or touch the information icon beside the Email control in the form.
	Shrink	Reduces the width of the control when placed in a row with other form controls.
	Expand	Increases the width of the control when placed in a row with other form controls.
Styling	CSS class	Add a CSS class to apply a style to this form control. You can create the CSS class in the CSS code editor in form styles. Enter one class name or multiple class names separated by a space. For more information, see Add a custom CSS to individual controls.
	Border color	Border color to apply to the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style.
	Control fill	The color to fill the inside of the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style.
	Control input color	The font color of the input in the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style.