Table of Contents
Common Fields
- Single Checkbox
- Date/Time
- Checkbox List
- Select Image
- Multi-Select
- Radio List
- Select
- Submit
- Paragraph Text
- Single Line Text
User Information Fields
Layout Fields
Miscellaneous Fields
Single Line Text
Single Line Text fields perfectly accommodate short answer user responses. User Information Fields pre-generated using the Single Line Text field include First Name, Last Name, Address, City, Zip, Email, and Phone fields.
General Settings
Label
The name of the field as displayed to your users.
Required Field
If enabled, this field must be completed before the form can be submitted.
Display Settings
Default Value
The field will load pre-populated with any text entered as the Default Value. This setting supports the use of merge tags to display unique or custom values.
Placeholder
Any text entered here will appear in the field when the form loads, but disappear when the user starts typing in the field.
Description
Any text entered here will appear between the label and the field.
Paragraph Text
The Paragraph field perfectly accommodates longer user responses that won’t fit in a Single Line Text field, and offers a rich text editor for the user if desired for formatting.
General Settings
Label
The name of the field as displayed to your users.
Required Field
If enabled, this field must be completed before the form can be submitted.
Display Settings
Default Value
The field will load pre-populated with any text entered as the Default Value. This setting supports the use of merge tags to display unique or custom values.
Placeholder
Any text entered here will appear in the field when the form loads, but disappear when the user starts typing in the field.
Description
Any text entered here will appear between the label and the field.
Show Rich Text Editor
If enabled, a rich text editor will be provided for the user to format their responses in this field. Off by default.
Radio List
The Radio List field presents options from which a user can make a single selection only.
General Settings
Label
The name of the field as displayed to your users.
Required Field
If enabled, this field must be completed before the form can be submitted.
Options
- Add New: adds another option to the list
- Label: The name of the list option displayed to the user
- “Check” column: Whichever list option checked here will display as the default option to the user
Display Settings
Description
Any text entered here will appear between the label and the field.
Select
The Select field is a list field that allows for one selection by the user from a drop-down. User Information Fields pre-generated using the Select field include Country and US States.
General Settings
Label
The name of the field as displayed to your users.
Required Field
If enabled, this field must be completed before the form can be submitted.
Options
- Add New: adds another option to the list
- Label: The name of the list option displayed to the user
- “Check” column: Whichever list option checked here will display as the default option to the user
Display Settings
Description
Any text entered here will appear between the label and the field.
Multi-Select
The Multi-Select field is a list field that allows for 2 or more selections by the user from a drop-down.
( As a note, to make multiple selections, clicking + pressing the command or shift key is required )
General Settings
Label
The name of the field as displayed to your users.
Required Field
If enabled, this field must be completed before the form can be submitted.
Options
- Add New: adds another option to the list
- Label: The name of the list option displayed to the user
- “Check” column: Whichever list option checked here will display as the default option to the user
Display Settings
Description
Any text entered here will appear between the label and the field.
Advanced Settings
Multi-Select Box Size
Adjusts the number of list option selections that are viewable by the user at one time / without scrolling through the list.
Select Image
The Select Image field is a list field that presents images as selectable list options. You can use any image from your Media Library as a list option. Users can make a single selection or multiple selections depending on your settings.
General Settings
Label
The name of the field as displayed to your users.
Required Field
If enabled, this field must be completed before the form can be submitted.
Image Options
- Add New: adds another option to the list
- Label: The name of the list option displayed to the user. The label will be pre-populated with the file name of the image, but can be changed.
- Image: Click the Media Library icon in this field to select an image from your Media Library that will display for this list option.
- “Check” column: Whichever list option checked here will display as the default option to the user
Image Display Options
- Show Labels: Show or hide the individual list options’ labels
- Allow Multiple Selections: If on (green), users can select 2+ list options instead of just 1
- List Orientation: Choose whether to display the image list options vertically (up/down) or horizontally (left/right).
- Number of Columns: When Horizontal orientation is selected, this number determines the maximum number of columns the field will display images in. Depending on screen size (how much room actually exists to display from left to right) the field may display fewer columns than this setting.
Display Settings
Description
Any text entered here will appear between the label and the field.
Advanced Settings
Multi-Select Box Size
Adjusts the number of list option selections that are viewable by the user at one time / without scrolling through the list.
Single Checkbox
The Single Checkbox field places a single checkbox on your form.
General Settings
Label
The name of the field as displayed to your users.
Required Field
If enabled, this field must be completed before the form can be submitted.
Default Value
Choose here whether the checkbox will be checked or unchecked by default when the user first views the form.
Display Settings
Description
Any text entered here will appear between the label and the field.
Checkbox List
The Checkbox List field allows for single or multiple checked selections.
General Settings
Label
The name of the field as displayed to your users.
Required Field
If enabled, this field must be completed before the form can be submitted.
Options
- Add New: adds another option to the list
- Label: The name of the list option displayed to the user
- “Check” column: Whichever list option checked here will display as the default option to the user
Display Settings
Description
Any text entered here will appear between the label and the field.
Date/Time
The Date/Time field introduces flatpickr. A lightweight and powerful datetime picker the user can use to select a date, from the calendar view and/or a time from a drop-down.
Pikaday was replaced with flatpickr in version 3.4.31 ( November 2020 ) of Ninja Forms
This is what the user will see when clicking on the field:
Front-End View
Users can click on a date to select it, and it will then be displayed in the field.
Edit Month
The arrow to the right of the month and left of the year can be used to navigate into the past or future one month at a time. Otherwise, the user can click the month drop-down to make their selection.
Edit Year
To edit the year, hover over the year field, which will trigger a set of up and down arrows that can then be used to make the selection. Alternatively, clicking the year field will allow you to edit the date by typing in the year.
Back-End view
General Settings
Date Only – Default –
- Default to Current Date – If enabled, the field will load pre-populated with the current date.
- Format
11 date formats
The Friday, November 10, 2019 format will be visible when the, default to the current date is enabled, otherwise you will need to manually create one in the placeholder field
Time Only
Front-End View of Time
- Enable/disable 24 hour setting
- Increment minutes – Default – 5 minute
Time only settings
Both Date & Time
Date & Time settings
Form > Advanced > Display Settings
Change the validation message for your date field.
Form > Advanced > Restrictions
Add Date/Time as a unique field to limit submissions.
Advanced Date/Time Add-On documentation here
Display Settings
Submit
Every form needs a Submit field. If you forget to add one, you’ll be prompted to do so when you Publish/save the form.
General Settings
Label
The name of the field as displayed to your users.
Processing Label
When the Submit button is pressed by a user, it will display “Processing” until the submission is complete. If you wish to change that language, you can do so here.
Address
The Address field is a Single Line Text field useful for entering street addresses. In addition to the default configuration for Single Line Text Fields, the Address field generates with the following additional properties:
- It has the Custom Name Attribute “address”
- It has the Autocomplete Attribute “address-line1”
- It is flagged as personally identifiable data by default
City
The City field is a Single Line Text field. In addition to the default configuration for Single Line Text Fields, the City field generates with the following additional properties:
- It has the Custom Name Attribute “city”
- It has the Autocomplete Attribute “address-level2”
The Email field is a Single Line Text field. In addition to the default configuration for Single Line Text Fields, the Email field generates with the following additional properties:
- It has the Custom Name and Autocomplete Attributes “email”
- It is flagged as personally identifiable data by default
- It enforces email address formatting
- The only permitted Restriction is Disable Browser Autocomplete
First Name
The First Name field is a Single Line Text field. In addition to the default configuration for Single Line Text Fields, the First Name field generates with the following additional properties:
- It has the Custom Name Attribute “fname”
- It has the Autocomplete Attribute “given-name”
- It is flagged as personally identifiable data by default
- The only permitted Restriction is Disable Browser Autocomplete
Last Name
The Last Name field is a Single Line Text field. In addition to the default configuration for Single Line Text Fields, the Last Name field generates with the following additional properties:
- It has the Custom Name Attribute “lname”
- It has the Autocomplete Attribute “family-name”
- It is flagged as personally identifiable data by default
- The only permitted Restriction is Disable Browser Autocomplete
Country
The Country field is a unique Select field. Unlike normal Select fields, the options list is pre-populated with a non-editable list of global countries which will appear in the user’s drop-down list when interacting with the field.
The Country field also includes the following General Settings:
Default Value
The field will load pre-populated with the country selected in the drop-down list.
US States
The US States field is a Select field. The options list is pre-populated with a list of states within the United States which will appear in the user’s drop-down list when interacting with the field, along with a “Select State” option which can be set as default.
Phone
The Phone field is a Single Line Text field for use with telephone numbers. In addition to the default configuration for Single Line Text Fields, the Phone field generates with the following additional properties:
- It has the Custom Name Attribute “phone”
- It has the Autocomplete Attribute “tel”
- It is flagged as personally identifiable data by default
Zip
The Zip field is a Single Line Text field for use with zip (or postal) codes. In addition to the default configuration for Single Line Text Fields, the Zip field generates with the following additional properties:
- It has the Custom Name Attribute “zip”
- It has the Autocomplete Attribute “postal-code”
HTML
The HTML field will allow for the display of formatted text, links, and media anywhere on your form. Just place the field anywhere on the form, and whatever you have input into this field will display at that location. Contents of an HTML field will not display in submission data.
General Settings
Label
The name of the field as displayed to your users.
Default Value
Whatever is input here will display on the form wherever the HTML field is placed. Take advantage of the rich text editor to format text, create headers, display images, video, links and more.
Divider
The Divider field simply adds a horizontal line across the form wherever this field is placed. Use to divide a single page into clean sections.
Repeatable Fieldset
The Repeatable Fieldset, or Repeater, is a field type that you can drag and drop other fields into:
Repeater field when first added to the form.
Note that fields can only be dragged and dropped into the repeater from the list of fields in the new field window at this time.
Repeater field viewed in the form builder containing a name and email field.
When a user views the form on the page, they will see all fields that you’ve placed inside the repeater as a group. Using an “Add” button, they can add as many groups of these fields as needed. The label of the repeater field and the text of the button can both be changed by adjusting the field’s Label setting.
Repeatable field containing a Name and Email field on a page.
For example, if you’re building an event registration form where the person submitting that form might want to add multiple guests, you might place a Name and Email field within the repeater. The user could then enter their own name and email, then press the Add button to also add the name and email of their first guess, again for their second guest, and so on.
Confirm
The Confirm field can be combined with any other field on your form to provide a way to validate the input into that field. Unless the Confirm field matches the chosen target field, the form will not submit. This can be used to confirm the entry of an email address, password, and other fields.
General Settings
Label
The name of the field as displayed to your users.
Required Field
If enabled, this field must be completed before the form can be submitted.This must be enabled for the validation feature to work.
Confirm
Select the field on the form you want the Confirm field to match/validate.
Display Settings
Default Value
The field will load pre-populated with any text entered as the Default Value. This setting supports the use of merge tags to display unique or custom values.
Placeholder
Any text entered here will appear in the field when the form loads, but disappear when the user starts typing in the field.
Description
Any text entered here will appear between the label and the field.
Hidden
The Hidden field does not display for users viewing the form. It can only be viewed from the form builder by a logged in administrator. Use this to store information that you want passed into submission data or sent along in an email, but not displayed to the user.
Please note if required fields are hidden, they are not going to be treated as required.
General Settings
Label
The name of the field as will be displayed in the Ninja Forms builder (not visible to users).
Default Value
The field will load pre-populated with any text entered as the Default Value. This setting supports the use of merge tags to display unique or custom values.
Number Field
The number field supports only numeric characters and comes with an up/down arrow for users to scroll through number values in designated steps.
General Settings
Label
The name of the field as displayed to your users.
Required Field
If enabled, this field must be completed before the form can be submitted. This must be enabled for the validation feature to work.
Number Options
- Min: The minimum value that a user can enter into this field
- Max: The maximum value that a user can enter into this field
- Step: Restricts the values that can be entered into the field by the increment entered here. Example: Step = 1 will allow for 1, 2, 3, 4, 5, etc but not 1.5 or 4.3. Step = 10 will allow for 10, 20, 30, 40, 50, etc but not 15 or 43. Enter .01 here to allow for numbers like 9.99, 15.49, etc.
The letter ‘e’ is allowed within the Number field for Scientific notation.
Example: 2.34 x 10E6 or 2.34 x 10^6 is equal to 2,340,000What is Scientific notation?
Scientific notation is the way that scientists easily handle very large numbers or very small numbers.
Display Settings
Default Value
The field will load pre-populated with any text entered as the Default Value. This setting supports the use of merge tags to display unique or custom values.
Placeholder
Any text entered here will appear in the field when the form loads, but disappear when the user starts typing in the field.
Description
Any text entered here will appear between the label and the field.
Recaptcha
The Recaptcha field links your form with Google’s reCAPTCHA technology, forcing a user to complete the reCAPTCHA challenge before the form can be successfully submitted.
For this field to work, you must link Ninja Forms to your Google account (see reCAPTCHA section). Failing to do this will result in a non-functional field.
General Settings
Label
The name of the field as displayed to your users if you choose for the reCAPTCHA to be visible.
Visibility
Select whether to display an “I’m not a robot” field or to detect if the user is a robot in the background.
Anti-Spam
Challenge your users with a question that must be answered correctly in order for the form to be submitted.
General Settings
Question
The question you want your users to answer in order to allow the form to be submitted.
Answer
The answer expected for the question setting. The users’ answer must match exactly. These are case sensitive.
Display Settings
Default Value
The field will load pre-populated with any text entered as the Default Value. This setting supports the use of merge tags to display unique or custom values.
Placeholder
Any text entered here will appear in the field when the form loads, but disappear when the user starts typing in the field.
Description
Any text entered here will appear between the label and the field.
Star Rating
The Star Rating field offers a “line-of-stars” graphic to the user, from which they can select a rating from a range of your choice.
General Settings
Label
The name of the field as displayed to your users.
Number of Stars
The number of stars that will appear in your “line-of-stars” graphic.
Required Field
If enabled, this field must be completed before the form can be submitted.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article