Skip to main content

How to Create Email Templates in UE Advocacy

T
Written by Tom Aristone

Email templates are how every email from your hub gets sent. Welcome emails, mission invites, reward confirmations, reference requests, weekly digests... all of it runs through templates you control.

This guide walks you through building them, the variables you can use for each event type, and a few gotchas to avoid.


Quick start (TLDR)

  1. Go to Communications in the left nav

  2. Pick the event type you want to build a template for

  3. Either edit the starter template we ship with your account or upload your own HTML

  4. Drag in the variables from the left sidebar so the email pulls in the right info (advocate name, mission title, etc.)

  5. Toggle Visual Editor in the top right to preview it

  6. Set the template to Live when you're ready

If you don't set up a custom template, we send a clean default for every event type so your advocates still get notified.


The 12 event types we support

Every email your hub sends maps to one of these 12 events. You can have a template for each one.

Event

When it sends

Member Joined

A new advocate joins your hub

Mission Created

A new mission is launched and assigned to advocates

Mission Reminder

Advocate hasn't completed an open mission yet

Mission Accepted

Advocate accepts a mission invite

Mission Declined

Advocate declines a mission invite

Mission Submitted

Advocate completes a mission and submits

Application Approved

Someone applies to your hub and gets approved in

Reward Redeemed

Advocate cashes in points for a reward

Reward Fulfilled

Reward order ships or gets delivered

End of Week Digest

Weekly summary of new missions, rewards, posts

Reference Request

Mission to ask an advocate to be a reference for a deal

Prospect Scheduling

Email to a prospect with the advocate's calendar link


Dynamic variables (and why they matter)

Variables are the {{stuff_in_double_curly_braces}} you'll see in the left sidebar of the editor. They pull live data into the email so every advocate gets a personalized version.

A couple things to know:

  • The variables in the left sidebar are the only ones we support. If you type in something custom like {{advocate initials}} or {{anything we didn't put there}}, it will not get filled in and will show up as raw text in the email.

  • If you want text that doesn't change (like "30-minute call" or your office address), just type it directly into the template. No variable needed.

  • Different event types support different variables. Always check the sidebar for the event you're editing.

Globally supported variables

These work in every template:

  • {{userFirstName}} — Advocate's first name. If we don't have it (Member Joined emails for example), it falls back to "Hey there"

  • {{brandName}} — Your company name

  • {{brandLogo}} — Your company logo

  • {{hubURL}} — Link to your advocacy hub

Variables by event type

Member Joined

  • {{userFirstName}}, {{brandName}}, {{hubURL}}

Mission Created / Reminder / Accepted / Declined / Submitted

  • {{userFirstName}}

  • {{missionTitle}}

  • {{missionDescription}}

  • {{missionPoints}} (only shows if mission rewards points)

  • {{missionRewardType}} (only shows if mission has a direct reward)

  • {{missionDeadline}}

  • {{missionURL}} (deep link to the mission)

Heads up: {{missionPoints}} and {{missionRewardType}} are mutually exclusive. A mission either gives points OR a direct reward, never both. Only the one you set will fill in.

Application Approved

  • {{userFirstName}}, {{brandName}}, {{hubURL}}

Reward Redeemed / Reward Fulfilled

  • {{userFirstName}}

  • {{rewardName}}

  • {{rewardDescription}}

  • {{rewardImage}}

  • {{pointsSpent}}

End of Week Digest

  • {{userFirstName}}

  • {{newMissionsList}}

  • {{newRewardsList}}

  • {{recentPostsList}}

  • {{userPointsBalance}}

Reference Request (sent to your advocate to opt in)

  • {{userFirstName}} (the advocate)

  • {{customText}} — free text the rep adds at the time of sending. Use this when you want the rep to drop in deal-specific context (prospect company, use case, etc.)

  • {{missionDeadline}}

  • {{missionPoints}} or {{missionRewardType}}

Note: {{prospectCompanyName}} is not a supported variable today. If you want to mention the prospect, use {{customText}} and the rep can type the prospect company in at the point of sending.

Prospect Scheduling (sent to the prospect with the advocate's calendar link)

  • {{advocateName}}

  • {{advocateTitle}}

  • {{advocateCompany}}

  • {{calendarLink}}

  • {{customText}}


Step-by-step: building a template

1. Pick your event type

Head to Communications in the left nav. You'll see a row of templates, one per event type. Each event has a starter template already set up so you don't have to start from scratch.

2. Edit the HTML or upload your own

Two paths here:

Path A — Use AI to spin up a branded version (recommended)

This is the fastest way to get a custom-branded template:

  1. Grab your brand guidelines (a tool like brandfetch.com works great if you don't have a style guide handy)

  2. Open ChatGPT, Claude, or your AI tool of choice

  3. Paste in the HTML from one of our starter templates

  4. Ask it to redo the design using your brand colors, fonts, and logo

  5. Copy the new HTML back into the template editor

Pro tip: ask the AI to only use the variables we support (paste the list from above into the prompt). Otherwise you'll end up with placeholders we can't fill in.

Path B — Build from scratch in the editor

You can write or paste in raw HTML directly. Just make sure you're using only the variables in the left sidebar.

3. Drag in your variables

This is the most important step. In the editor:

  1. Look at the left sidebar for the list of variables for this event type

  2. Drag them into your template where you want them to fill in

  3. Or type them by hand using the exact format {{variableName}}

4. Preview with the Visual Editor

In the top right corner, toggle Visual Editor. Then drag the HTML box into the preview area. This shows you what the email will actually look like when it sends.

Heads up: if you toggle Visual Editor and just see "Hello world", you need to drag the HTML block into the preview area. It doesn't auto-render.

5. Set it Live (and decide on Preview Mode)

Once you're happy, toggle the template to Live. That's what tells our system to use your custom version instead of the default starter template.

When you set a template Live, you'll see a toggle for Preview before sending (sometimes called "Preview Messages" or "Preview Notifications"). This is one of the most important decisions you'll make. Read the next section before you flip it.

If you want to turn a template off, just toggle Live to off. We'll fall back to the default starter template (so emails still send, just unbranded).


Preview Mode: read this before going Live

This is the #1 thing customers get tripped up on, so worth its own section.

What Preview Mode does

When Preview before sending is ON for a template:

  • Emails do not auto-send to your advocates or prospects

  • Instead, every email gets staged in your Communications tab with an Approve button

  • An admin has to manually click Approve before the email goes out

  • The "preview" notification gets sent to whatever email is configured in your account settings (which is why you might see emails landing in your work inbox instead of the recipient's)

When Preview before sending is OFF:

  • Emails auto-send to the actual recipient as soon as the trigger fires (member joins, mission accepted, application approved, etc.)

  • Nothing for the admin to do, fully hands-off

When to use each

Turn Preview ON if:

  • You're testing a new template and want to spot-check what's going out

  • You have a sensitive use case (like reference requests) where you want a human in the loop before emailing customers

  • Your reference workflow needs admin approval before contacting an advocate

Turn Preview OFF if:

  • The email is high-volume or needs to feel real-time (welcome emails, mission invites, weekly digests)

  • You don't want admins to have to manually approve every email

  • You're past testing and ready for the system to run on its own

Common gotcha (please read)

If you set a template Live with Preview ON and forget about it, emails will pile up in your Communications tab unsent. Advocates and prospects won't get anything. We've seen this happen on:

  • Application Approved emails (advocate applies, gets accepted, never gets the welcome email)

  • Reference Request emails (rep submits, advocate never opts in because they never got pinged)

  • Mission Created emails (mission goes live, no one knows)

If you ever notice emails not landing where you expect, first check the Communications tab for pending approvals. That solves it 9 times out of 10.

How to switch Preview on or off

You can toggle this when you set a template Live. If the toggle isn't showing for an already-Live template, duplicate it, set the new one to Live with the right Preview setting, and delete the old one. Or just ping our team and we'll flip it for you.


What if I don't set up a template?

You're covered. Every event type ships with a clean default starter template that uses your brand logo and colors. So even if you do nothing, your advocates still get notified for every event.

But the defaults are pretty plain. If you want emails that look like they came from your team, build out custom templates for at least your top 3 to 5 events (Member Joined, Mission Created, Reference Request, Prospect Scheduling, Reward Redeemed are the most common starting points).


Need to send an email we don't have a template for? Use Send Update.

The 12 event types cover the main automated emails your hub sends. But sometimes you want to send a one-off email that doesn't map to any of those events.

For that, use the Send Update engagement type.

Send Update lets you blast a one-off email to a segment of your advocates without it being tied to a mission, reward, or any other system event. You write the message, pick the audience, and send.

Good use cases for Send Update

  • Product update or release announcements

  • Event invites (webinars, advisory boards, customer dinners)

  • Holiday or thank-you notes

  • Re-engagement campaigns for inactive advocates

  • Heads-up before a big mission drops

  • Anything else you'd normally send from your marketing tool

How to use it

  1. Go to Engagements and create a new engagement

  2. Pick Send Update as the type

  3. Write your title and body copy

  4. Pick the segment you want to send to

  5. Send it

Heads up

Send Update only supports a title and a description right now (no rich HTML body like you'd build in a template). If you need a fully designed email, your best bet is to either build a Mission Created template that's styled the way you want and run it as a custom mission, or wait for us to expand Send Update.


FAQ and troubleshooting

Sending and deliverability

  • My emails aren't reaching advocates or prospects (or are going to my work inbox instead). 99% of the time this is Preview Mode being on. Check the Communications tab for pending approvals. See the Preview Mode section above.

  • My emails are landing in spam or promotions. This usually means you haven't set up a branded sending domain yet. By default we send from a UE-branded address, which works but doesn't get the best deliverability. The fix is to set up a branded domain so emails come from [email protected] instead. Ping our team to get the SPF and DKIM records you'll need to give your IT team.

  • Can I change the sender name and reply-to email? Yes. Both can be customized in your settings. The sender name is what advocates see in their inbox ("From: Acme Customer Team" instead of "From: noreply"). The reply-to is where any responses go. We strongly recommend setting both to something branded so emails don't look like spam.

  • My emails look like spam to my advocates. Three things to check: (1) is your sender name set to a real human or team name (not "noreply")? (2) is your reply-to a monitored inbox? (3) is your branded domain set up? Fixing all three usually solves it.

  • Test sending: how do I send myself a test before going Live? For weekly digests, there's a Send Test Digest button in the digest editor. For other event-triggered emails, the easiest way is to add yourself as an advocate, trigger the event (apply, accept a mission, redeem a reward), and watch your inbox. If you have Preview Mode on, you'll need to check the Communications tab and approve.

Variables and personalization

  • My variable shows up as raw text in the sent email. You used a variable we don't support. Check the left sidebar for the exact list. Anything not in there won't fill in.

  • Why does the admin preview show {{userFirstName}} instead of a real name? Dynamic variables get inserted at the moment the email actually sends, so the admin preview shows the raw template. The advocate will see "Hi Sarah" not "Hi {{userFirstName}}". This is a known UX wart we're working on.

  • What happens to {{userFirstName}} when we don't have the advocate's first name yet? This comes up most often with Member Joined emails when someone signs up with just an email. We fall back to "Hey there" in that case. Future emails will fill in the name once they complete onboarding.

  • Can I add a custom variable like {{advocateInitials}} or {{prospectCompanyName}}? Not today. The only supported variables are the ones in the left sidebar of the editor. For things like prospect company on a reference request, use {{customText}} and let the rep type it in at the point of sending.

  • Where does the Mission Declined "decline reason" text come from? Whatever the admin enters in the Declined Feedback field gets inserted into the email as custom text. The advocate sees the reason and can resubmit.


Editing and template management

  • Why can't I edit my Live template's Preview Mode setting? Once a template is Live, the Preview toggle doesn't show on edit. The current workaround is to duplicate the template, set the new one to Live with the right Preview setting, then delete the old one. We're working on making this editable in place.

  • My HTML edits aren't saving. Hard refresh the page and try again. If it still won't save, try creating a new template instead of editing the existing one (we've seen edge cases where edit/delete is broken on certain older templates). Ping our team in Slack if it persists.

  • My HTML isn't showing up in the visual editor. Toggle Visual Editor in the top right AND drag the HTML block into the preview area. It doesn't auto-render.

  • Can I have multiple templates per event type? Yes. You can build several per event and pick which one is Live at any time. Useful for A/B testing, seasonal swaps, or having different templates for different mission types (e.g. one Mission Created template for content missions, another for events).

Reference workflows

  • The reference request email never went out to my advocate. Two things to check, in order: (1) Preview Mode on the Reference Request template (most common cause) or (2) you have a reference approval workflow with multiple steps and didn't approve all of them

  • Can I CC someone on reference request emails? Yes, if you have the data. Whatever field you map to the CC list (account owner email, CSM email, etc.) gets pulled in automatically.


Need help?

Drop a message in your dedicated Slack channel and our team will jump in.

Did this answer your question?