bookmark_borderField Merge Tags

Summary

Displays the value submitted for the field with the specified field_id. If no value was submitted, the merge tag will not display anything. Modifiers are also available to display other data related to the field.

Usage

{[descriptor]:[field_id]}

{:[field_id]}

{[descriptor]:[field_id]:[modifier]}

Parameters

[descriptor]

Optional. A user defined value for readability. By default when using the merge tags widget, this will be the field name. Since this is optional, {:[field_id]} will work also.

[field_id]

Required. This is the value of the field_id, which may be a single number for the field, or a multi-part number for multi-part fields that have more than one field within them, such as the Name field.

Example: {text:4} will select field ID 4. {name:5.3} will target the 3rd part of the field ID 5, such as the first name within a name field. If in doubt as to how to determine your field ID, use the merge tag dropdown widget to select the field by name and the proper ID will be inserted for you. For

[modifier]

Optional. A list of possible modifiers are listed below.

Modifiers

:label

Displays the field label.

:url

Applies only to fields of type List.
Displays the list field content in a format that is URL friendly.
i.e. col1_row1|col2_row1,col1_row2|col2_row2
{List:5:url}

:value

Applies only to fields of type Drop Down, Checkbox and Radio Button.
Displays the selected item’s value. Applicable if the field was configured with ‘enable values’.
{Field:5:value}

:id

Applies only to the fields of type Category.
Displays the selected category’s id rather than label.
{Category:5:id}

:price

Applies only to Pricing fields of type Drop Down and Radio Button, and the Total field.
Displays the selected product’s price in numeric format (i.e. 500).
{Product:5:price}

:currency

Applies only to Pricing fields of type Drop Down and Radio Button, and the Total field.
Displays the selected product’s price in currency format (i.e. $500.00).
{Product:5:currency}

:qty

Applies only to drop down and radio button pricing fields.
Displays the selected product’s quantity.

:numeric

Converts the number string or currency value as a decimal-formatted number.
{Field:5:numeric}

Notes

Refer to the field types User Guide documentation for specific information on merge tags or modifiers specific to that field type.