Forms

Other articles in this category

Search More Content

Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages

Common Form Field Settings

Introduction

When editing a form, many of the fields you use will offer the same group of settings. This article helps explain the most common ones.

Fields usually offer three tabs of field settings:
– General
– Appearance
– Advanced

The settings most commonly offered in each of these tabs are listed below.

General Settings Tab

Field Label

This is the name by which this field is displayed. The field label is shown on the front-end (that is, displayed to people when they fill out a form you have embedded on your site), as well as used to refer to that field within form administration areas where choosing the field is required. Such as for conditional logic, merge fields, or even in the Entries list.

Description

An extended text area used to annotate the purpose or instructions on filling this field. If included, it will be displayed with the form.

Maximum Characters

Determines the maximum number of characters that can be entered in this field. Offered for longer fields such as the Paragraph field.

Input Mask

Available for Single Line Text fields, when this setting is toggled to on, the form administrator may specify a specific format to be accepted in this field. the field will then provides visual guidance to form users on the expected format as well as enforce the input format for during entry.

Once you turn on the input mask option, you will be presented with the option of a standard (predefined) input mask, or you an create a custom input mask. *Standard input masks* include common options such as date, phone number, or US zip code.

Required

If a field is marked as required, then the form cannot be submitted without it.

No Duplicates

Select this option to limit user input to unique values only. This means that for a form submission to be accepted, the value entered must not already exist in the form entry database for that field.

Appearance Settings Tab

The Appearance tab usually contains the following common field settings:

Placeholder

A placeholder is text shown inside the blank field to help the user know what is expected. If the field is left blank at submission time, the placeholder text is not saved with the entry. That field will be blank in the Entry table.

Field Label Visibility

Choose from the drop down to determine if you want the field label to be shown on the form. If shown, the placement of the label is inherited from whatever you have specified within the Form Settings.

Description Placement

Choose where you would like the description to appear, own relation to the input field.

Custom Validation Message

This is a custom message that displays when an attempted entry fails validation for this field. The message appears in red, below the field upon an invalid submission. Note that all fields that are validated will generate a simple, default error message. Use this setting if you wish to customize it.

Example of a custom validation message

Custom CSS Class

Add any custom CSS class you have defined if you wish to apply it to this field and override the default style.

Field Size

The choice of small, medium or large affects the width of the entry area for most fields. For a paragraph field, it affects the height. By default, it is medium.

Advanced Settings Tab

The Advanced tab of field settings often contains the following common options:

Admin Field Label

This is the field label that will be shown within the administrative interfaces. It does not affect what a form visitor would see.

Default Value

The value will be used to pre-populate the field when initially loaded and presented to visitor. If unchanged during form submission, it will also be saved with the Entry. A merge tags marker is also presented next to this field, meaning that merge tags can also be utilized to determine the default value.

Enable Password Input

Toggling this setting on means that the text typed in this form field will be hidden to the user with a default “•” character.

Visibility

Controls whether or not the field will be visible to a form viewer. Options include:

  • Visible: default option, field shows normally.
  • Hidden: this field will be hidden from a form viewer, but will still exist. This is useful when you need the field to execute or be used in some functionality (such as capturing a piece of capture information, or be utilized in conditional logic elsewhere in the form), but do not want the form viewer to put an input here.
  • Administrative: the field is not visible to a form viewer and will not add any functionality to the form. It can still affect an entry though in that default values will be captured in the Entry table.
Allow field to be populated dynamically

Checking this option allows data to be passed to the form and pre-populate the field dynamically. Data can be passed via Query Strings, Shortcode and/or Hooks.

Enable Conditional Logic

Check this to turn on conditional logic, which will control whether this field is shown or hidden. If left unchecked, this field will be shown by default. See this article for more information.