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:textbox, 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,