Custom Mailing Fields¶

What Are Mailing Fields?¶

As with custom page fields, you can use these fields to insert a section of content or code in your Mailing or Email wrapper, or to create a mailing template.

After you've created the custom Mailing Field, add the field to the body of your Mailing using this syntax: {{ custom_fields.FIELD_NAME }}. Or, if your custom Mailing Field contains template tags or filters that need to be interpreted, then use this syntax instead: {% include_tmpl custom_fields.FIELD_NAME %}.

Then in the custom field row toward the bottom of the screen, select the field name on the left and enter the value on the right.

What Types Of Mailing Fields Can I Add?¶

You can set a content type for custom fields which will provide different input options and validations for different types of fields.

Available types are:

Text: Auto-expanding text input field with a "max length" option to address one of the most common validation patterns.
Select From List: Provides a select menu for campaigners.
Select From List With Other: Same as above, plus an "other" choice that reveals a text input field for free entry.
Integer: Only accepts numbers, and also provides up/down arrows to increase/decrease the value.
HTML: Uses our standard visual editor with code/plain options. Note that the contents of this field will render as text unless autoescape is off.
Web address URL: Input field with validation for HTTP or HTTPS URLs.
Image address URL: Type-to-select that displays matching options (with thumbnails!) from your media library. You can also enter a a web address.
Color Hex Code: Provides a color picker or campaigners can type in a 3- or 6-digit hex code.
Date: Displays a calendar widget for entering dates in year-month-day format, like 2019-12-31.
Date and Time: Displays a calendar and scrolling time widget for entering dates and times in year-month-day 24-hour format, like 2019-12-31 23:59.
Time: Displays a scrolling widget for entering times in 24-hour format, like 23:59.