Modifier: :value
:value means different things depending on the merge tag or the kind of field:
- Stored value, not the label on Checkboxes, Radio buttons, Drop down, Multi select, Post category, Image choice, Multiple choice fields
- Number without thousands separators on Number fields
- Repeater stored values on Repeater fields
- Stored values instead of choice text on {all_fields}, {pricing_fields}
- Status number on {approval_status}
Stored value, not the label
On Checkboxes, Radio buttons, Drop down, Multi select, Post category, Image choice, Multiple choice fields.
Outputs the choice's stored value. Outranks price and currency on every choice field.
| Product | Gravity Forms |
|---|---|
| Requires | Gravity Forms 1.9 or later |
| Works on | Checkboxes, Radio buttons, Drop down, Multi select, Post category, Image choice, Multiple choice fields |
| In the picker | What to show |
How to use it
Use stored values instead of labels
Choices store a value separate from the label people see (here the label is Pepperoni); a script or a URL usually wants the value. One checkbox is written with its input number.
Write
https://example.com/order?topping={Toppings:6.2:value}Get
https://example.com/order?topping=pepperoniExamples
Rendered by real Gravity Forms and GravityKit PHP against a test entry.
| Merge tag | Output | Without the modifier |
|---|---|---|
{Toppings:6:value} | pepperoni, mushroom | Pepperoni, Mushroom |
Where the merge tag picker offers it
Form fields: Drop down · Radio buttons · Checkboxes · Checkboxes, one choice · Multi select · Image choice · Multiple choice · Post category.
Number without thousands separators
On Number fields.
On a Number field, value suppresses the thousands separator rather than selecting a stored value.
| Product | Gravity Forms |
|---|---|
| Requires | Gravity Forms 1.9.5 or later |
| Works on | Number fields |
| In the picker | What to show |
Examples
Rendered by real Gravity Forms and GravityKit PHP against a test entry.
| Merge tag | Output | Without the modifier |
|---|---|---|
{Plain Number:25:value} | 9876.54 | 9,876.54 |
Where the merge tag picker offers it
Form fields: Number.
Repeater stored values
On Repeater fields.
Forces text format and emits stored values rather than choice text.
| Product | Gravity Forms |
|---|---|
| Requires | Gravity Forms 2.4 or later |
| Works on | Repeater fields |
| In the picker | What to show |
Where the merge tag picker offers it
Form fields: Repeater.
Stored values instead of choice text
On {all_fields}, {pricing_fields}.
| Product | Gravity Forms |
|---|---|
| Requires | Gravity Forms 1.9 or later |
| Works on | {all_fields}, {pricing_fields} |
| In the picker | Other settings |
Examples
Rendered by real Gravity Forms and GravityKit PHP against a test entry.
| Merge tag | Output | Without the modifier |
|---|---|---|
{all_fields:value} | HTMLFull Name ada Lovelace Notes it's -- <b>QUICK</b>, brown Fox jumps over the lazy dog and it wasn't <b>that</b> slow & steady. Ada Lovelace wrote the first algorithm. Event Date Text March 3, 2026 Tags red, green, blue Contact Email [email protected] Toppings pepperoni mushroom Category Baked Goods Amo… | HTMLFull Name ada Lovelace Notes it's -- <b>QUICK</b>, brown Fox jumps over the lazy dog and it wasn't <b>that</b> slow & steady. Ada Lovelace wrote the first algorithm. Event Date Text March 3, 2026 Tags red, green, blue Contact Email [email protected] Toppings Pepperoni Mushroom Category Baked Goods Amo… |
{pricing_fields:value} | HTMLOrder Product Qty Unit Price Price LW 1 $10.00 $10.00 Widget 3 $10.00 $30.00 Sub Total $40.00 Total $40.00 | HTMLOrder Product Qty Unit Price Price Large Widget 1 $10.00 $10.00 Widget 3 $10.00 $30.00 Sub Total $40.00 Total $40.00 |
Where the merge tag picker offers it
Merge tags: {all_fields} · {pricing_fields}.
Status number
On {approval_status}.
The stored number instead of the words: 1 approved, 2 disapproved, 3 unapproved. Any other modifier falls through to the words.
| Product | GravityView |
|---|---|
| Requires | GravityView 1.18 or later |
| Works on | {approval_status} |
| In the picker | What to show |
Examples
Rendered by real Gravity Forms and GravityKit PHP against a test entry.
| Merge tag | Output |
|---|---|
{approval_status:value}Rendered against an entry nine days older, where the result differs. | 3 |
Where the merge tag picker offers it
Merge tags: {approval_status}.