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

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, `