Field types
Every field has a Label (up to 100 characters) and optional Help text (up to 500 characters). This page lists what each type adds. For how to use them, see the Build templates guides.
Summary
Section titled “Summary”| Type | Goes on | Changes | Use for |
|---|---|---|---|
| Text | Any element that holds text | The element’s content | Headlines, labels, prices, addresses |
| Rich text | <td>, <th> or <div> | The element’s content | Body copy |
| Image | <img> | src and alt, optional link | Pictures, logos |
| Link | <a> | href and text | Buttons, text links, social icons |
| Colour | Any marked element(s) | Style properties or attributes | Backgrounds, text and border colours |
| Choice | Any marked element(s) | Style properties or attributes | Alignment, layout, presets |
| Toggle | Any marked element(s) | Removes elements, hides fields | Optional parts |
| Repeater | Any element | Repeats the element per item | Product cards, link lists |
| Setting | Values | Default |
|---|---|---|
| Marker | A marker in the part | None |
| Required | On or off | Off |
| Multi-line | On or off. Line breaks become <br>. | Off |
| Character limit | 1 to 100,000, or none | None |
| Fill from | A product’s title, price, compare-at price, vendor or product type; or a WordPress output field | None |
Builds as: the element’s content replaced by the escaped text. The element’s own attributes and styles are kept.
Can’t go on: void elements (<img>, <br>, <hr> and so on), or an element with other markers inside it.
Rich text
Section titled “Rich text”| Setting | Values | Default |
|---|---|---|
| Marker | A marker on a <td>, <th> or <div> | None |
| Required | On or off | Off |
| Character limit | 1 to 100,000, or none. Counts text, not tags. | None |
| Paragraph style | CSS declarations, such as margin:0 0 16px | None |
| Link style | CSS declarations, such as color:#18181b;text-decoration:underline | None |
| Fill from | A WordPress output field | None |
Builds as: the element’s content replaced by cleaned HTML. Allowed tags are p, br, strong, em, u, s, a, ul, ol and li. Links keep only a safe href. Other attributes are removed. The paragraph style is written on every <p> and the link style on every <a>.
Style declarations can’t contain quotes, <, >, braces or line breaks.
| Setting | Values | Default |
|---|---|---|
| Marker | A marker on an <img> | None |
| Required | On or off | Off |
| Can link | On or off. Marketers may add a link around the image. | Off |
| Fill from | A product’s image, or a WordPress output field | None |
Builds as: the <img> with its src and alt set. With a link, the <img> is wrapped in <a href="…">. Alt text is never required.
| Setting | Values | Default |
|---|---|---|
| Marker | A marker on an <a> | None |
| Required | On or off | Off |
| URL only | On or off. Only the href changes; what’s inside the link stays. | Off |
| Character limit | 1 to 100,000, or none. Applies to the link text. | None |
| Fill from | A product page (URL only, or title and URL), or a WordPress URL field (optionally with the post title as text) | None |
Builds as: the <a> with its href set and, unless URL only, its text replaced.
Colour
Section titled “Colour”| Setting | Values | Default |
|---|---|---|
| Required | On or off | Off |
| Sets | One or more targets: a marker plus a CSS style property or an attribute | None |
Values: hex colours, #rgb or #rrggbb.
Builds as: each target’s style property set in the element’s style attribute, or its attribute set. An empty, optional colour leaves the HTML as written.
Choice
Section titled “Choice”| Setting | Values | Default |
|---|---|---|
| Sets | Targets: a marker plus a CSS style property or an attribute | None |
| Options | Two or more, each with a label and a value per target | None |
| Default option | One of the options | Required |
Builds as: the chosen option’s value set on each target. A target with no value in the chosen option is left as written.
Values can be up to 500 characters and can’t contain ;, ", <, >, braces or line breaks.
Marketers see buttons for up to three short options, otherwise a dropdown.
Toggle
Section titled “Toggle”| Setting | Values | Default |
|---|---|---|
| On by default | On or off | Off |
| Removes from the email | Markers in the part | None |
| Hides in the form | Fields and groups in the form | None |
| Fill from | A product’s on sale, sold out or in stock; or a WordPress true/false field | None |
Builds as: while off, each removed marker’s element is left out of the email with everything inside it. While on, the HTML is unchanged.
Repeater
Section titled “Repeater”| Setting | Values | Default |
|---|---|---|
| Marker | A marker in the part | None |
| Fewest items | 0 to 100 | 0 |
| Most items | 1 to 100, or none | None |
| Item fields | Any field type except repeater | None |
| Post types | WordPress post types items can be picked from | Any |
| Fill with the latest when added | How many (1 to 100) and order | Off |
Builds as: the element repeated once per item, each copy filled with that item’s fields. A repeater that has never been filled in shows its element once, as written.
Targets
Section titled “Targets”Colour and choice fields set targets. A target is:
- a marker, and
- either a style property, such as
background-color,color,paddingorborder-top-color, written into the element’sstyleattribute, - or an attribute, such as
bgcolor,align,dir,widthorvalign.
An attribute can’t be style (use a style property), data-mm or an event handler such as onclick.
| Where | Allowed schemes |
|---|---|
| Link fields, linked images, rich text links | https, http, mailto, tel, or no scheme |
| Image fields | https, http, or no scheme |
URLs with no scheme, such as {{unsubscribe_url}} or *|UNSUB|*, pass through for your ESP. javascript: and data: URLs are refused and reported as problems.