Option

Summary

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.

GForms Option Field Icon

Option field as displayed in the Field Library

Image showing the Option field in the form editor.

Option field as displayed in 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.

Common Settings

This field uses only common field settings for the Advanced settings. For a description of each of the common field settings, refer to this article. Below you will find description of specialty settings that are particular to this field.

General Settings

GForms Option Field General Settings
SettingDescription
Product Field MappingSelect 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 TypeSelect the type of field from the available form fields. See Field Types Options below.

Field Types Options

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

Choices

The Edit Choices button allows you to edit the Label, Value and Price for each choice.

Click the Edit Choices button under Choices to open the Edit Choices flyout.

Image showing choice for the Option field with a default choice selected
SettingDescription
ChoicesAdd Choices to this field. You can mark each choice as checked by default by using the checkbox that appears 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 ValuesAllows 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.
Clear default choicesAllows you to clear the choice set as default. Only available when a choice has been selected as the default choice.
Bulk Add / Predefined ChoicesAllows you to select a category and customize the predefined choices or paste your own list to bulk add choices. See note 1.

Notes

1. See this article for more information on bulk loading choices.

Appearance Settings

SettingDescription
Enable enhanced user interfaceBy selecting this option, the Chose jQuery library will become active, allowing drop downs to be searched.

Merge Tags

For more information on the use of merge tags, refer to these articles.

Usage

{Field Name:2}

Modifiers

This merge tag does not have any modifiers.