Textbox
Memo
Integer
Decimal
Dropdown List
Optional Text
Date & Time
Detailed Syntax Rules
Note: Brackets [ ] denote optional items.
Textbox
A single line text field. Use this field to request a customer’s name, an apartment number, the name of the product they ordered, etc.
Syntax
%%type:textbox, label:[, default:][, size:small|medium|large]%%
Parameters
| Label (required) | Label displayed in the editor. E.g. “Customer Name.” |
| Default (optional) | Default value prepopulated in the field. |
| Size (optional) | Defines the width of the input field. Small, medium, or large. |
Example
%%type:textbox, label:Product Name, default:chair%%
Memo
A multi-line text field. Use this field to request a custom message to your customer, a multi-line address, or a description of a product, etc.
Syntax
%%type:memo, label:[, default:][, size:small|medium|large]%%
Parameters
| Label (required) | Label displayed in the editor. E.g. “Product description.” |
| Default (optional) | Default value prepopulated in the field. |
| Size (optional) | Defines the width of the input field. Small, medium, or large. |
Example
%%type:memo, label:Product Description%%
Integer
A single integer. Use this field to request a quantity, age, discount percent, SKU number, etc.
Syntax
%%type:integer, label:[, default:][, min:][, max:][, size:small|medium|large]%%
Parameters
| Label (required) | Label displayed in the editor. E.g. “Item Count”. |
| Default (optional) | Default value prepopulated in the field. |
| Min (optional) | The minimum value that will be accepted in the field. |
| Max (optional) | The maximum value that will be accepted in the field. |
| Size (optional) | Defines the width of the input field. Small, medium, or large. |
Example
%%type:integer, label:Item Count, default:1, min:1, max:10%%
Decimal
A decimal. Use this field to request a dollar amount, precise discount percentage, etc.
Syntax
%%type:decimal, label:[, default:][, min:][, max:][, size:small|medium|large]%%
Parameters
| Label (required) | Label displayed in the editor. E.g. “Discount”. |
| Default (optional) | Default value prepopulated in the field. |
| Min (optional) | The minimum value that will be accepted in the field. |
| Max (optional) | The maximum value that will be accepted in the field. |
| Size (optional) | Defines the width of the input field. Small, medium, or large. |
Example
%%type:decimal, label:Discount, default:10.0, min:1.0, max:100%%
Dropdown List
A pre-defined list of options. Use this field to request one of multiple colors, discounts, subscription types, etc.
Syntax
%%type:dropdown, label:, 1:[, 2:]...[, N:]%%
Parameters
| Label (required) | Label displayed in the editor. E.g. “Subscription Type”. |
| 1 (required) | The first option to display in the dropdown. |
| N (optional) | Additional options to display in the dropdown. You can have as many of these as you want. |
| Default (optional) | Default value prepopulated in the field. |
Example
%%type:dropdown, label:Subscription Type, 1:Standard, 2:Premium, 3:Elite%%
Optional Text
An optional block of text added by checking a checkbox. Use this field to add optional text, e.g. return instructions, terms of service, etc.
Syntax
%%type:checkbox, label:, content:%%
Parameters
| Label (required) | Label displayed in the editor. E.g. “Include Terms of Service?”. |
| Content (required) | The text to include if the checkbox is selected. |
Example
%%type:checkbox, label:Include Terms of Service?, content:By responding to this email you agree to Acme Sprocket’s terms of service.%%
Date & Time
Date and time stamps. There are many formats. Use this if you want to include the current month, day, date, time, etc.
Syntax
%%type:datetime, format:YYYY-MM-DDTHH:mm:ss.SSSZ%%
Parameters
| Unit | Token | Result examples |
| Month | M | 1, 2, …, 12 |
| Mo | 1st, 2nd, …, 12th | |
| MM | 01, 02, …, 12 | |
| MMM | Jan, Feb, …, Dec | |
| MMMM | January, February, …, December | |
| Quarter | Q | 1, 2, 3, 4 |
| Qo | 1st, 2nd, 3rd, 4th | |
| Day of month | D | 1, 2, …, 31 |
| Do | 1st, 2nd, …, 31st | |
| DD | 01, 02, …, 31 | |
| Day of year | DDD | 1, 2, …, 366 |
| DDDo | 1st, 2nd, …, 366th | |
| DDDD | 001, 002, …, 366 | |
| Day of week | d | 0, 1, …, 6 |
| do | 0th, 1st, …, 6th | |
| dd | Su, Mo, …, Sa | |
| ddd | Sun, Mon, …, Sat | |
| dddd | Sunday, Monday, …, Saturday | |
| Day of ISO week | E | 1, 2, …, 7 |
| ISO week | W | 1, 2, …, 53 |
| Wo | 1st, 2nd, …, 53rd | |
| WW | 01, 02, …, 53 | |
| Year | YY | 00, 01, …, 99 |
| YYYY | 1900, 1901, …, 2099 | |
| ISO week-numbering year | GG | 00, 01, …, 99 |
| GGGG | 1900, 1901, …, 2099 | |
| AM/PM | A | AM, PM |
| a | am, pm | |
| aa | a.m., p.m. | |
| Hour | H | 0, 1, … 23 |
| HH | 00, 01, … 23 | |
| h | 1, 2, …, 12 | |
| hh | 01, 02, …, 12 | |
| Minute | m | 0, 1, …, 59 |
| mm | 00, 01, …, 59 | |
| Second | s | 0, 1, …, 59 |
| ss | 00, 01, …, 59 | |
| 1/10 of second | S | 0, 1, …, 9 |
| 1/100 of second | SS | 00, 01, …, 99 |
| Millisecond | SSS | 000, 001, …, 999 |
| Timezone | Z | -01:00, +00:00, … +12:00 |
| ZZ | -0100, +0000, …, +1200 | |
| Seconds timestamp | X | 512969520 |
| Milliseconds timestamp | x | 512969520900 |
Example
%%type:datetime, format:MMMM Do YYYY%%
Detailed Syntax Rules
If you’ve ever seen JSON, you know that our syntax looks a lot like it, with a few rule relaxations:
- You don’t need to quote property names:
{ foo:"bar baz", red:255 } - You don’t need the top level braces:
foo:"bar baz", red:255 - You don’t need to quote strings with spaces:
foo:bar baz, red:255 - You do need to quote strings if they contain a comma or closing brace or square bracket:
icky:",}]" - You can use single quotes for strings:
Jules:'Cry "Havoc," and let slip the dogs of war!' - You can have trailing commas:
foo:bar, red:255,