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

Fields Available for Forms

The Form Toolbox consists of 3 primary field types: Standard, Advanced and Post. To add a field to a form simply click on the name of the field you would like to add. To edit a field you have added to a form, simply hover over the field you would like to edit and click the edit link. To a delete a field you can click the Delete link, be aware that Deleting a field will also delete all entry data associated with that form field.

Common Settings

Most of the following fields use common field settings for the General, Appearance, and Advanced settings. For a description of each of the common field settings, refer to this article.

Standard Fields

Standard Fields are basic form fields that can be customized for just about any use. These can be used to capture and store a variety of data when an advanced field is not available to meet your needs.

Single Line Text

Introduction

The Single Line Text field allows users to submit a single line of text. This basic field can be used for anything where no more than a single line of input is required. It is available under the Standard Fields section within the form editor.

Merge Tags

Usage

{Field Name:2}

Paragraph Text

Introduction

The Paragraph Text field allows a user to enter text in a textarea form field. It is available under the Standard Fields section within the form editor.

Advanced Settings

Use the Rich Text Editor

Check this option to enable the rich text editor on this field. Note that if you already have entry data associated with this field, you will not be able to enable the rich text editor. You will need to delete the field to enable the rich text editor on an existing field, which will remove all entry data associated with the field.

Merge Tags

Usage

{Field Name:2}

Drop Down

Introduction

The Drop Down field allows users to select one option from a list. It is available under the Standard Fields section within the form editor.

Important: If your choice labels contain any HTML or special characters such as ampersands, commas, hyphens or brackets of any type, you MUST enable the show values feature and give each choice a simple and unique value which does not contain any special characters. Failure to configure values could cause issues for features such as calculations, conditional logic, dynamic population, and validation.

General Settings

Choices

Add Choices to this field. You can mark each choice as checked by default by using the radio buttons that appear to the left of each choice. Add a new choice by clicking the PLUS icon and delete a choice by clicking the DELETE icon.

Show Values

Checking this option will allow you to specify a value for each choice. Choice values are not displayed to the user viewing the form but are accessible to administrators when viewing the entry.

Bulk Add / Predefined Choices

Clicking the Bulk Add / Predefined Choices allows you to select a category and customize the predefined choices or paste your own list to bulk add choices. See this article for more information.

Appearance Settings

Placeholder

The Placeholder will not be submitted along with the form. You can use the Placeholder to require the user to select any of choices.

Enable enhanced user interface

By selecting this option, the chosen jQuery script will be applied to this field, enabling search capabilities to Drop Down fields and a more user-friendly interface for Multi Select fields.

Advanced Settings

Default Value

Pre-populates the value of the Drop Down field. Enter the choice you would like to display.

Merge Tags

Usage

{Field Name:2:modifier}

Modifiers

  • :value
    Outputs the value of the field instead of the choice label.
  • :currency
    Converts the value to a currency value.

Calculations

If you’re going to use this field type in a calculation formula, please check Number Formatting Rules in the Calculations doc page.

Multi Select

Introduction

The Multi Select field allows users to select multiple options available in the multi select box. It is available under the Standard Fields section within the form editor.

Important: If your choice labels contain any HTML or special characters such as ampersands, commas, hyphens or brackets of any type, you MUST enable the show values feature and give each choice a simple and unique value which does not contain any special characters. Failure to configure values could cause issues for features such as calculations, conditional logic, dynamic population, and validation.

General Settings

Choices

Add Choices to this field. You can mark each choice as checked by default by using the radio buttons that appear to the left of each choice. Add a new choice by clicking the PLUS icon and delete a choice by clicking the DELETE icon.

Show Values

Checking this option will allow you to specify a value for each choice. Choice values are not displayed to the user viewing the form but are accessible to administrators when viewing the entry.

Bulk Add / Predefined Choices

Clicking the Bulk Add / Predefined Choices allows you to select a category and customize the predefined choices or paste your own list to bulk add choices. See this article for more information.

Appearance Settings

Enable enhanced user interface

Checking this option enables enhanced functionality to make this more user-friendly.

Merge Tags

Usage

{Field Name:2}

Number

Introduction

The Number field allows a user to enter a number. The field then automatically validates the form data to insure that a number was entered. You can also set a minimum and maximum number and the field will validate that the entered data is within that range. It is available under the Standard Fields section within the form editor.

General Settings

Number Format

Select the format of numbers that are allowed in this field. You have the option to use a comma or a dot as the decimal separator.

Range

Enter the minimum and maximum values for this form field. This will require that the value entered by the user must fall within this range.

Enable Calculation

Enabling calculations will allow the value of this field to be dynamically calculated based on a mathematical formula.

Merge Tags

Usage

{Field Name:2:modifier}

Modifiers

  • :value
    Tells the merge tag to not use a thousands separator, and instead use the numeric value of the field. Not applicable to currency values.
Checkboxes

Introduction

The Checkboxes field allows you to present one or many checkboxes which allow multiple selections. It is available under the Standard Fields section within the form editor.

Important: If your choice labels contain any HTML or special characters such as ampersands, commas, hyphens or brackets of any type, you MUST enable the show values feature and give each choice a simple and unique value which does not contain any special characters. Failure to configure values could cause issues for features such as calculations, conditional logic, dynamic population, and validation.

Important: Once the form has entries the choices should not be changed. Adding, removing, re-ordering, or renaming checkbox choices will result in the input ids associated with the choices changing which could break the connection to the choices already stored in the existing entries and prevent them being exported.

General Settings

Choices

Add Choices to this field. You can mark each choice as checked by default by using the checkbox that appear to the left of each choice. Add a new choice by clicking the PLUS icon and delete a choice by clicking the DELETE icon.

Show Values

Checking this option will allow you to specify a value for each choice. Choice values are not displayed to the user viewing the form, but are accessible to administrators when viewing the entry.

Bulk Add / Predefined Choices

Clicking the Bulk Add / Predefined Choices allows you to select a category and customize the predefined choices or paste your own list to bulk add choices. See this article for more information.

Enable “Select All” choice

Checking this adds a Select All option to the top of the checkboxes list which allows the user to select all of the available list items.

Merge Tags

Usage

{Field Name:2.1:modifier1}
Notes:

  • The field name is optional.
  • The second parameter is the field ID. If a single number, it can be used to get the value of the field ID. If multiple numbers separated by a period, it will get a specific selection within that field. For example, 2 will return the result of field ID 2, while 2.1 will return the first checkbox within field ID 2.
  • The third, and any subsequent parameters are used for modifiers. These are separated by a colon, and may contain multiple modifiers if applicable.

Modifiers

  • :value
    Displays the actual value of the checkbox rather than the value label.
  • :currency
    Displays the value as currency.
  • :price
    Same as :currency.

Calculations

If you’re going to use this field type in a calculation formula, please check Number Formatting Rules in the Calculations doc page.

Radio Buttons

Introduction

The Radio Buttons field allows users to select one option from a list. Only one option from the available choices can be selected. It is available under the Standard Fields section within the form editor.

Important: If your choice labels contain any HTML or special characters such as ampersands, commas, hyphens or brackets of any type, you MUST enable the show values feature and give each choice a simple and unique value which does not contain any special characters. Failure to configure values could cause issues for features such as calculations, conditional logic, dynamic population, and validation.

General Settings

Choices

Add Choices to this field. You can mark each choice as checked by default by using the radio buttons that appear to the left of each choice. Add a new choice by clicking the PLUS icon and delete a choice by clicking the DELETE icon.

Show Values

Allows you to specify a value for each choice. Choice values are not displayed to the user viewing the form but are accessible to administrators when viewing the entry.

Bulk Add / Predefined Choices

Allows you to select a category and customize the predefined choices or paste your own list to bulk add choices. See this article for more information.

Enable “other” choice

Add a text input as the final choice of your radio button field. This allows the user to specify a value that is not a predefined choice.

Merge Tags

Usage

{Field Name:2.1:modifier}

Modifiers

  • :value
    Outputs the value of the field instead of the normal choice text.
  • :currency
    Converts the value to a currency value.

Calculations

If you’re going to use this field type in a calculation formula, please check Number Formatting Rules in the Calculations doc page.

Example: Changing the Button Display

The display of the radio button choices can be modified by using the gf_list category of CSS ready classes.

For example, to display the choices horizontally rather than vertically, enter the gf_list_inline CSS ready class in the field’s Custom CSS Class field under the Appearance tab.

This turns a multiple choice list into an inline horizontal list (not evenly spaced columns).

Refer to this article for a list of CSS Ready Classes.

Hidden

Introduction

The Hidden field can be used to store information that should not be visible to the user but can be processed and stored with the user submission. It is available under the Standard Fields section within the form editor.

Merge Tags

Usage

{Field Name:2}

HTML

Introduction

The HTML field allows you to place a block of free form HTML anywhere in your form. This is useful for adding images or additional content. It is available under the Standard Fields section within the form editor.

General Settings

Content

Enter the content (Text or HTML) to be displayed on the form.

Disable default margins

When enabled margins are added to properly align the HTML content with other form fields.

Merge Tags

HTML fields are display only fields, not saved in the entry, therefore they don’t have a merge tag.

Section Break

Introduction

The Section Break field allows you to add a content separator to your form to help organize groups of fields. This is a visual element rather than an actual data collecting form field. It is available under the Standard Fields section within the form editor.

Advanced Settings

Enable Conditional Logic

Create rules to dynamically display or hide this section based on values from another field. Remember, to use conditional logic, you will need to first add any field supported by conditional logic (e.g. a drop down, checkboxes, etc). Note that conditional logic applied to a section applies to any field under that section too until a new section, a page break or the end of the form is found.

Page break

Introduction

The Page Break field allows the creation of multi-page forms. Adding a Page Break field will automatically enable the multi-page functionality for your form. There are three pieces to the Page Break functionality: the Start Paging field, the Page Break field, and the End Paging field. The Page Break field is available under the Standard Fields section within the form editor.

Start Paging

The Start Paging field will always appear at the top of your form beneath the Form Settings field (after a Page Break field is added to your form). This field is used to specify general options for your multi-page functionality such as whether to use a progress bar and if so what type.

General Settings

Progress Indicator

Select which type of visual progress indicator you would like to display. Available options are Progress Bar, Steps or None.

Style

Select which progress bar style you would like to use. Select custom to choose your own text and background color.

Page Names

Name each of the pages on your form. Page names are displayed with the selected progress indicator.

Display completed progress bar on confirmation

Check this box if you would like the progress bar to display with the confirmation text

Page Break

The Page Break field allows you to specify where one page ends and the next begins. You can add as many Page Break fields as you need and each field can be configured to customize the settings for that page. Modifying the Next and Previous buttons, adding conditional logic to determine whether to show or hide the page, and adding a special CSS class for the page are all possible with the Page Break field settings.

General Settings

Next Button

These options allow you to modify the page next button.

  • Default
    Enter the text you would like to appear on the page next button.
  • Image
    Enter the path to an image you would like to use as the page next button.
Previous Button

These options allow you to modify the page previous button.

  • Default
    Enter the text you would like to appear on the page previous button.
  • Image
    Enter the path to an image you would like to use as the page previous button.

End Paging

The End Paging field only provides one option: to modify the Previous Button.

General Settings

Previous Button

These options allow you to modify the page previous button.

  • Default
    Enter the text you would like to appear on the page previous button.
  • Image
    Enter the path to an image you would like to use as the page previous button.

Advanced Fields

Advanced Fields are more advanced form field types with specific usage in mind. Advanced fields may actually contain multiple fields in one container. These fields make it easy to capture data such as a users Name, Address, etc.

Name

Introduction

The Name field allows users to enter their name in the format you have specified via the General tab. This allows you to capture name information as individual fields. It is available under the Advanced Fields section within the form editor.

General Settings

Name Fields

Select the fields that you would like to enable, as well as set any custom labels.

Appearance Settings

Sub-Label Placement

Similar to the description placement, this determines where the sub-labels will be located.

Merge Tags

Usage

Display the Prefix.
{Field Name:2.2}
Display the First Name.
{Field Name:2.3}
Display the Middle Name.
{Field Name:2.4}
Display the Last Name.
{Field Name:2.6}
Display the Suffix.
{Field Name:2.8}
Notes:

  • The first of these merge tag parameters is optional and is simply the field name for easier identification.
  • The second parameter defines the field or input ID within the form.
Date

Introduction

The Date field allows you to present a field that captures date data using the jQuery UI date picker. It is available under the Advanced Fields section within the form editor.

General Settings

Date Input Type

Select the type of inputs you would like to use for the date field:

  • Date Picker will let users select a date from a calendar.
  • Date Field will let users free type the date.
  • Date Drop Down will let users select date from drop downs.
Icon

Allows you to set an icon which will be listed beside the date field. Available options are:

  • No Icon
  • Calendar Icon
  • Custom Icon
Date Format

Select the format you would like to use for the date input. Available options are MM/DD/YYYY and DD/MM/YYYY.

Merge Tags

Usage

{Field Name:2:modifier}
Notes:

  • The field name is optional.
  • The second parameter defines the ID of the field that will be output in this tag.
  • Within the third parameter, you can define an optional modifier to use. Only one modifier can be used per merge tag.

Modifiers

  • :year
    Outputs only the year used in the field.
  • :month
    Outputs only the month used in the field.
  • :day
    Outputs only the day used in the field.
  • :ymd
    Outputs the date formatted as year/month/day. Example: 2016/10/31.
  • :dmy
    Outputs the date formatted as day/month/year. Example: 31/10/2016.
Time

Introduction

The Time field allows users to submit a time as hours and minutes. This field automatically validates that the information entered was formatted correctly. It is available under the Advanced Fields section within the form editor.

General Settings

Time Format

Select the format you would like to use for the time field. Available options are 12 hour (i.e. 8:30 pm) and 24 hour (i.e. 20:30).

Custom Sub-Label

Enter values in this setting to override the sub-label for each field.

Appearance Settings

Sub-Label Placement

Similar to the Description Placement option, but instead changes the sub-label placement.

Merge Tags

Usage

{Field Name:2}
Notes:

  • The first of these merge tag parameters is optional and is simply the field name for easier identification.
  • The second parameter defines the field ID within the form. In the example above, it would be field ID 2.
Phone

Introduction

The Phone field allows users to enter a phone number. The field will automatically format the entered data based on the selected phone format in the General settings (see note below). It is available under the Advanced Fields section within the form editor.

General Settings

Phone Format

Select the format you would like to use for the phone input. Available options are domestic US/CANADA style phone number and international long format phone number.

Merge Tags

Usage

{Field Name:2}
Notes:

  • The first of these merge tag parameters is optional and is simply the field name for easier identification.
  • The second parameter defines the field ID within the form. In the example above, it would be field ID 2.

Modifiers

This field does not have any modifiers.

HTML5 Input Type

In order to utilize the HTML5 tel input type for the phone field, you must have Output HTML5 turned on within the General Settings page. This is found under Forms -> Settings.

Address

Introduction

The Address field makes it quick and easy to capture address information on a form. This field provides a pre-formatted area for two street addresses, city, state/province, zip/postal code, and a drop down for country selection. It is available under the Advanced Fields section within the form editor.

General Settings

Address Type

Select the type of address you would like to use.

International

The International address type is the default address type and supports most address formats internationally.

United States

The United States address type is formatted specifically for addresses within the United States.

Canadian

The Canadian address type is formatted specifically for addresses within Canada.

Address Fields

Within this section, you can use the toggle switches to enable or disable specific data within the address field.

Default Country/State/Province

Based on your selection within the Address Type, options will dynamically populate for the default country, state, or province. They can be selected here if you would like these to default to a specific location.

Appearance Settings

Sub-Label Placement

Similar to the Description Placement option, but instead applies to the sub-label.

Advanced Settings

Display option to use the values submitted in different field

This may be used to populate the field from the information on another field. This is useful in cases such as shipping/billing address fields, where they may be the same information.

Option Label

This determines the text that will be displayed next to the checkbox listed next to the field, which allows copying of the data. An example of this would be: Copy address from billing address.

Source Field

Within this option, you will determine the field that will provide the data to this field.

Activated by default

This option is used to activate population of the field based on another, by default.

Conditional Logic Support

You can configure conditional logic rules on other fields based on the values of the Address field inputs.

Merge Tags

Usage

Display the Street Address.
{Field Name:2.1}
Display the Address Line 2.
{Field Name:2.2}
Display the City.
{Field Name:2.3}
Display the State / Province.
{Field Name:2.4}
Display the ZIP / Postal Code.
{Field Name:2.5}
Display the Country.
{Field Name:2.6}

Website

Introduction

The Website field allows users to enter a website URL. This field automatically validates that the information entered was formatted correctly. It is available under the Advanced Fields section within the form editor.

Merge Tags

Usage

{Field Name:2}
Notes:

  • The first of these merge tag parameters is optional and is simply the field name for easier identification.
  • The second parameter defines the field ID within the form. In the example above, it would be field ID 2.
Email

Introduction

The Email field allows you to present a field that captures email data. It is available under the Advanced Fields section within the form editor.

General Settings

Enable Email Confirmation

Prompts the user to confirm the email address.

Merge Tags

Usage

{Field Name:2}

File Upload

Introduction

The File Upload field allows users to upload a file with their form submission. You may limit which filetypes a user may upload via the properties tab. It is available under the Advanced Fields section within the form editor.

General Settings

Allowed file extensions

Enter the allowed file extensions for file uploads. This will limit what type of files a user may upload.

Enable Multi-File Upload

If checked, this option allows the user to upload multiple files. If unchecked (default state), the upload will accept only a single file. Note that once an entry has been submitted using this field, this option will no longer be editable. That is, you cannot switch a file upload field from from single file to multi-file once an entry with a file has been submitted.

Maximum File Size

Use this to specify the maximum size in megabytes allowed for each of the files.

Merge Tags

Usage

{Field Name:2:modifier}

Modifiers

  • :download
    Denotes that the link created for the download should force the download when accessed.
CAPTCHA

Introduction

The CAPTCHA field allows you to add a captcha field to your form, to help protect your website from spam and bot abuse by trying to determine if the form is being submitted by a human, or defeating a form submission attempt by a scripted bot. The Gravity Forms Captcha field is available under the Advanced Fields section within the form editor.

Types

Gravity Forms supports Google’s free reCaptcha service. There are different types of reCaptcha, and the Gravity Forms captcha field supports:

  • reCaptcha v2 Checkbox
  • reCaptcha v2 Invisible

Gravity Forms does not support v3 reCaptcha at this time.

reCaptcha API Keys

A matched pair containing a site key and a secret key are required to link the reCaptcha service to your Gravity Forms site installation.

For Google reCaptcha, you will need to sign up for a free account to get your keys. From there, you can generate one or more pairs of the type of reCaptcha keys you wish to implement. reCaptcha v2 checkbox keys will only allow you to add a v2 checkbox on your form, while v2 Invisible keys will allow you to choose either v2 reCaptcha type. Older keys will not work.

Once you have your key pair, you will need to add them to the Gravity Forms Settings Page, and if appropriate, choose the type of reCaptcha you wish to use.

Note that this is a site wide setting, and as such, you cannot vary the reCaptcha type used from form to form on the same site.

General Settings

Theme

This option is only available when using reCAPTCHA. Select the visual theme for the reCAPTCHA field from the Light and Dark options to better match your site design.

Advanced Settings

Language

This option is only available when using reCAPTCHA. Select the language you would like to use for the reCAPTCHA display from the available options.

Password

Introduction

The Password field provides two single line inputs (one to enter the password and the second to confirm it) that will mask entered content with blobs or asterisks. It is available under the Advanced Fields section within the form editor. The Password field is only available when the User Registration add-on is active.

General Settings

Toggle Confirm Password Input

This toggle allows you to control the visibility of the confirm password input.

Enable Password Visibility Toggle

Enabling this option adds a toggle allowing the user to see the password they are entering in rather than the masked characters.

Enable Password Strength

Enabling this option will force the user to enter a password which meets the minimum strength requirement. This feature utilizes the same library that WordPress core does to determine the level of strength for the password entered into the form by the user.

Minimum Strength

Set the minimum strength requirement for the password. Options are None, Short, Bad, Good, and Strong.

Custom Sub-Labels

Enter values in this setting to override the default sub label for each field.

List

Introduction

The List field allows the end user to add/remove additional rows (up to a pre-set limit) of information per field. This allows for the capture of multiple field values, or a variable “list” of data as defined by the end user. This is a simple version of a repeater field. The List field is available under the Advanced Fields section within the form editor.

General Settings

Enable multiple columns

Checking this option enables the list field to have multiple fields per row. You may add as many columns as you need, each column with its own unique label.

Maximum Rows

Enter the maximum number of rows that users are allowed to add.

Advanced Settings

Add Icon URL

Enter the URL of a custom image to replace the default ‘Add a new row’ icon +.

Delete Icon URL

Enter the URL of a custom image to replace the default ‘Remove this row’ icon -.

Merge Tags

Usage

{Field Name:2:modifier}

Modifiers

  • :text
    To output the list items as text instead of HTML formatted.

Post Fields

Post Fields are form fields that enable you to capture data that is then used to create a WordPress Post. These fields make it quick and easy for you to create forms that allow users to submit content to your site. The result posts will be set as a Draft and will need to be published before they are visible.

Post Title

Introduction

The Post Title field allows users to submit data that is then used to populate the title for a post. It is available under the Post Fields section within the form editor. This field works in tandem with the other Post fields to allow you to create a form that can generate post data from a user submission.

General Settings

Post Status

Select the post status that will be used for the post that is created by the form entry. Available options are Draft, Pending Review, and Published.

Default Post Author

Select the author that will be used for the post that is created by the form entry.

Use logged in user as author

Sets the post author to the WordPress user that submitted the form.

Post Category

Select the category that will be used for the post that is created by the form entry.

Create Content Template

Check this option to format and insert form fields into the Post Title.

Merge Tags

Usage

{Field Name:2}

Post Body

Introduction

The Post Body field allows users to submit data that is then used as the body content for a post. It is available under the Post Fields section within the form editor. This field works in tandem with the other Post fields to allow you to create a form that can generate post data from a user submission.

General Settings

Post Status

Select the post status that will be used for the post that is created by the form entry. Available options are Draft, Pending Review, and Published.

Default Post Author

Select the author that will be used for the post that is created by the form entry.

Use logged in user as author

Sets the post author to the WordPress user that submitted the form.

Post Category

Select the category that will be used for the post that is created by the form entry.

Create Content Template

Check this option to format and insert form fields into the Post Content.

Merge Tags

Usage

{Field Name:2}

Post Excerpt

Introduction

The Post Excerpt field allows users to submit data that is then used to populate the excerpt of a post. This field works in tandem with the other Post fields to allow you to create a form that can generate post data from a user submission. It is available under the Post Fields section within the form editor.

General Settings

Post Status

Select the post status that will be used for the post that is created by the form entry. Available options are Draft, Pending Review, and Published.

Default Post Author

Select the author that will be used for the post that is created by the form entry.

Use logged in user as author

Sets the post author to the site user that submitted the form.

Post Category

Select the category that will be used for the post that is created by the form entry.

Merge Tags

Usage

{Field Name:2}

Post Tags

Introduction

The Post Tags field allows users to submit data that is then used to populate the tags for a post. This field works in tandem with the other Post fields to allow you to create a form that can generate post data from a user submission. It is available under the Post Fields section within the form editor.

General Settings

Field Type

Select the type of field that should be used to allow users completing the form to specify post tags. By default the Single Line Text field type is selected. This allows users to enter a comma delimited list to specify post tags. The Drop Down, Multi Select, Checkboxes, and Radio Buttons options allow you to specify a predefined list of tags for selection.

Merge Tags

Usage

{Field Name:2}

Post Category

Introduction

The Post Category field allows the user to select a category for the post they are creating. This field works in tandem with the other Post fields to allow you to create a form that can generate post data from a user submission. It is available under the Post Fields section within the form editor.

General Settings

Field Type

Select the type of field from the available form fields.

Category

Select which categories are displayed. You can choose to display all of them or select individual ones.

Display Placeholder

Check this option to enable a default instructional option as the first option rather than having the first option default to a category.

Advanced Settings

Visibility

Select the visibility for this field. Field visibility set to Everyone will be visible by the user submitting the form. Form field visibility set to Admin Only will only be visible within the Gravity Forms administration tool. Setting a field to Admin Only is useful for creating fields that can be used to set a status or priority level on submitted entries.
Note: This is especially useful for the Category field as it allows the admin to specify a default category for posts created through this form without this field being visible to users.

Merge Tags

Usage

{Field Name:2}

Post Image

Introduction

The Post Image field allows users to upload an image that is added to the Media Library and Gallery for the post that is created. It is available under the Post Fields section within the form editor. This field works in tandem with the other Post fields to allow you to create a form that can generate post data from a user submission. The Post Image allows users to upload the following filetypes: GIF, JPG, and PNG.

Unlike regular file uploads, files uploaded with this field type are not deleted from the WordPress Media Library when Gravity Forms entries are deleted.

General Settings

Image Metadata

Select one or more image metadata fields to be displayed along with the image upload field. They enable users to enter additional information about the uploaded image.

Set as Featured Image

Check this option to set the image uploaded as the Featured Image for the generated post.

Merge Tags

Usage

{Field Name:2:modifier}

Modifiers

By default, the tag outputs the URL of the image.

  • :title
    Displays the image title.
  • :caption
    Displays the image caption.
  • :description
    Displays the image description.
Post Custom Field

Introduction

The Post Custom Field allows users to submit data that is then used to populate a custom field value for a post. This field works in tandem with the other Post fields to allow you to create a form that can generate post data from a user submission. It is available under the Post Fields section within the form editor.

General Settings

Field Type

Select the type of field from the available form fields.
Note: the Post Custom Field will assume the properties and options of the selected field type. For example, if Single Line Text is selected, the Maximum Characters and Enable Password Input options would become available for this field.

Custom Field Name

Select the custom field name from available existing custom fields, or enter a new custom field name.

Create Content Template

Check this option to format and insert form fields as the content of this field. See this article for more information.

Merge Tags

Usage

{Field Name:2}

Pricing Fields

Pricing Fields are form fields that enable you to create products

Product

Introduction

The Product field allows the creation of products in the form. There are several options for the type of field that should be used for the Product Field: Single Product, Drop Down, Radio Buttons, and User Defined Price. It is available under the Pricing Fields section within the form editor.

Important: If you use a choice based field type and your choice labels contain any HTML or special characters such as ampersands, commas, hyphens or brackets of any type, you MUST enable the show values feature and give each choice a simple and unique value which does not contain any special characters. Failure to configure values could cause issues for features such as calculations, conditional logic, dynamic population, and validation.

General Settings

Field Type

Select the type of field from the available form fields.

  • Single Product
    The Single Product field type will display the price and a quantity field by default.
  • Drop Down
    The Drop Down field type will display as a drop down field on your form. When this option is selected, the General tab will refresh with options to specify multiple products.
  • Radio Buttons
    Similar to the Drop Down option, but radio buttons instead.
  • User Defined Price
    The User Defined Price field type will display as a single line input on your form.
  • Hidden
    If set to Hidden, the product field will not be shown, but will still be processed upon submission.
  • Calculation
    Generates product information based on calculations.

Price

Enter the base price for this product.

Disable Quantity Field

Disables the quantity field. A quantity of 1 will be assumed or you can add a Quantity field to your form from the Pricing Fields.

Merge Tags

Usage

{Field Name:2}

Option

Introduction

The Option field allows the creation of options for products created by a Product. Option fields have special functionality which displays how much selecting the option will add (or subtract) from the total. It is available under the Pricing Fields section within the form editor.

Important: If your choice labels contain any HTML or special characters such as ampersands, commas, hyphens or brackets of any type, you MUST enable the show values feature and give each choice a simple and unique value which does not contain any special characters. Failure to configure values could cause issues for features such as calculations, conditional logic, dynamic population, and validation.

General Settings

Product Field Mapping

Select which product this field is tied to. This option is only available when there are two or more products. When only one product exists, Option and Quantity will automatically apply to that product.

Field Type

Select the type of field from the available form fields.

  • Drop Down
    The Drop Down field type will display as a drop down field on your form.
  • Checkboxes
    The Checkboxes field type will display as a group of checkbox fields on your form.
  • Radio Buttons
    The Radio Buttons field type will display your product options as radio buttons.

Appearance Settings

Enable enhanced user interface

By selecting this option, the Chose jQuery library will become active, allowing drop downs to be searched.

Merge Tags

Usage

{Field Name:2}

Quantity

Introduction

The Quantity field allows a quantity to be specified for Product. It is available under the Pricing Fields section within the form editor.

General Settings

Product Field Mapping

Select which product this field is tied to. This option is only available when there are two or more products. When only one product exists, Option and Quantity will automatically apply to that product.

Field Type

Select the type of field from the available form fields.

  • Number
    The Number field type will display as a Number on your form. This option also enables the Number Range property.
  • Drop Down
    The Drop Down field type will display as a drop down field on your form. When this option is selected, the General tab will refresh with options to specify multiple quantity choices.
  • Hidden
    The Hidden field type will display as a hidden field on your form. This field type is useful when wishing to set a quantity without that quantity being visible or editable by the user.
Number Format

Select the format of the numbers that are allowed in this field. You have the option to use a comma or a dot as the decimal separator.

Range

Enter the minimum and maximum values for this form field. This will require that the value entered by the user must fall within this range.

Note: This option is only available when the Number field type is selected.

Merge Tags

Usage

{Field Name:2}

Decimal Quantity

Decimal values are supported by default when the field is set to Drop Down type. If you’re going to use this field type in a calculation formula, please check the Number Formatting Rules in the Calculations doc page.

Shipping

Introduction

The Shipping field allows a shipping fee to be added to the form total. It is available under the Pricing Fields section within the form editor.

Important: If you use a choice based field type and your choice labels contain any HTML or special characters such as ampersands, commas, hyphens or brackets of any type, you MUST enable the show values feature and give each choice a simple and unique value which does not contain any special characters. Failure to configure values could cause issues for features such as conditional logic.

General Settings

Field Type

Select the type of field from the available form fields.

  • Single Method
    The Single Method field type will display just the shipping price.
  • Drop Down
    The Drop Down field type will display as a drop down field on your form. When this option is selected, the General tab will refresh with options to specify multiple shipping prices.
  • Radio Buttons
    The Radio Buttons field type will display as a field of radio buttons on your form. When this field type is selected, the General tab will refresh with options to specify multiple shipping prices.
Price

Enter the base price for this product.
Note: This option is only available when the Single Method field type is selected.

Merge Tags

Usage

{Field Name:2}

Total

Introduction

The Total field specifies where the order total should be displayed in the form. As the user selects products and options, the total will automatically update. It is available under the Pricing Fields section within the form editor.

Merge Tags

Usage

{Field Name:2:modifier}

Modifiers

  • :price
    Used to denote that the amount displayed by the merge tag should be formatted as currency.