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,