{"id":"6aef4b4d4d670dd6061d0742","title":"Event Templates","path":"how-to/committee/email-articles/mail-settings/event-templates","contentMarkdown":"# Event Templates\n\n[Email Configurations](https://ngx-ramblers.org.uk/how-to/committee/email-articles/mail-settings/email-configurations) control the whole email: subject, banner, sender, recipients and wording. **Event templates** control each walk or social-event item inside that email, including its image, and the same format is used in printed programmes.\n\nOpen [Admin → Mail Settings → Event Templates](https://ngx-ramblers.org.uk/admin/mail-settings?tab=event-templates \"{{siteUrl}}\").\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/247913a5-ca2a-48e2-aa79-81b2c02a9a13.png)\n\n*[Admin → Mail Settings → Event Templates](https://ngx-ramblers.org.uk/admin/mail-settings?tab=event-templates \"{{siteUrl}}\"), next to Email Configurations.*\n\n## Choose a format\n\nThe **Existing format** list is every saved event format on the site. Pick one to load it. **Format name** is the label the email composer shows.\n\n- **Save changes** updates the format you have open.\n- **Save as new** keeps the original. Change the name first, then save a copy.\n\nThe built-in listings (for example a three-column programme listing) are a starting point. Groups usually keep one or two formats that match how they like walks to look in a newsletter.\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/5c142a0b-4534-41b9-bc2f-d76a6cfb917a.png)\n\n*Choose a format, edit the repeating item, then Save changes or Save as new. Merge-field chips stand in for title, date, contact and other event fields.*\n\n## Edit the repeating item\n\nThe editor is one walk or social, not the whole email. Insert merge fields from the editor toolbar (title, date, time, distance, grade, location, grid reference, contact, description, image, and the event page link). Those tokens are filled from the real event when the email or PDF is built.\n\nColoured chips in the editor are merge fields. Linked fields (grid reference, contact email, event page) render as links. The image field inserts the event photo at the height set in the editor.\n\n## Live preview\n\nBelow the editor is a live preview that uses real events from the site. Choose event types and a few events, optionally include images, then switch **Email** or **PDF**. Editing the markdown updates the preview immediately. The events themselves are not changed.\n\nYou need at least one event selected to see a listing. The preview is the repeating block only, not a complete newsletter.\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/88ab7feb-f34d-4ce3-aacc-7fe1ed2db2f2.jpeg)\n\n*Live preview uses real site events. Pick types and events below this heading, then Email or PDF.*\n\n## Use it in the composer\n\nWhen you write an email, the **Events** step has **Event format**. Built-in listings are listed first. **Saved event template** uses a format from this page. **Manage event templates** opens [Admin → Mail Settings → Event Templates](https://ngx-ramblers.org.uk/admin/mail-settings?tab=event-templates \"{{siteUrl}}\") in a new tab.\n\nSave the email draft to keep the format you chose. [Preview & Review](https://ngx-ramblers.org.uk/how-to/committee/email-articles/sending-emails-walkthrough) has Email and PDF views of the finished message.\n\n> **Related**\n>\n> [Email Configurations](https://ngx-ramblers.org.uk/how-to/committee/email-articles/mail-settings/email-configurations)\n>\n> [Composer walkthrough](https://ngx-ramblers.org.uk/how-to/committee/email-articles/sending-emails-walkthrough)\n>\n> [Sending Emails](https://ngx-ramblers.org.uk/how-to/committee/email-articles/sending-emails)\n","contentHtml":"

Event Templates

\n

Email Configurations control the whole email: subject, banner, sender, recipients and wording. Event templates control each walk or social-event item inside that email, including its image, and the same format is used in printed programmes.

\n

Open Admin → Mail Settings → Event Templates.

\n

\"\"

\n

Admin → Mail Settings → Event Templates, next to Email Configurations.

\n

Choose a format

\n

The Existing format list is every saved event format on the site. Pick one to load it. Format name is the label the email composer shows.

\n\n

The built-in listings (for example a three-column programme listing) are a starting point. Groups usually keep one or two formats that match how they like walks to look in a newsletter.

\n

\"\"

\n

Choose a format, edit the repeating item, then Save changes or Save as new. Merge-field chips stand in for title, date, contact and other event fields.

\n

Edit the repeating item

\n

The editor is one walk or social, not the whole email. Insert merge fields from the editor toolbar (title, date, time, distance, grade, location, grid reference, contact, description, image, and the event page link). Those tokens are filled from the real event when the email or PDF is built.

\n

Coloured chips in the editor are merge fields. Linked fields (grid reference, contact email, event page) render as links. The image field inserts the event photo at the height set in the editor.

\n

Live preview

\n

Below the editor is a live preview that uses real events from the site. Choose event types and a few events, optionally include images, then switch Email or PDF. Editing the markdown updates the preview immediately. The events themselves are not changed.

\n

You need at least one event selected to see a listing. The preview is the repeating block only, not a complete newsletter.

\n

\"\"

\n

Live preview uses real site events. Pick types and events below this heading, then Email or PDF.

\n

Use it in the composer

\n

When you write an email, the Events step has Event format. Built-in listings are listed first. Saved event template uses a format from this page. Manage event templates opens Admin → Mail Settings → Event Templates in a new tab.

\n

Save the email draft to keep the format you chose. Preview & Review has Email and PDF views of the finished message.

\n
\n

Related

\n

Email Configurations

\n

Composer walkthrough

\n

Sending Emails

\n
\n"}