<p>Under Settings > Email there is a field called "HTML Email Template" which you can use to point to a single template that handles all of the system emails. It's not very obvious from the Craft UI, but you can use that single template as a routing mechanism for including per-email templates using the variable <code>emailKey</code> which is available in the template. Your routing template could look like this:</p>

<pre><code>{# Craft has four predefined email keys:

    account_activation
    verify_new_email
    forgot_password
    test_email

... route to them here, or fallback to default
#}

{% include [
    '_emails/' ~ emailKey ?? null,
    '_emails/default'
] %}
</code></pre>

<p>You'd then have another template called <code>account_activation.twig</code> where you can go wild with whatever modifications you like. Each email also has a <code>link</code> variable available in the template to output the link to whatever it is.</p>

CC BY-SA 4.0
2022-04-28T18:11:52.207Z
This works great for HTML emails, but I noticed the plain text component of the email is still using the system messaging (easy to spot if using MailHog in development). Any idea how to target updating the text version also?
Nate Beaty
CC BY-SA 4.0
2022-04-29T16:19:39.363Z
great question, let me know here if you find out a way!
James Smith
CC BY-SA 4.0
2023-05-21T20:04:10.220Z
For now I just ended up editing the text message in Utilities > System Messages, so they at least match up roughly with my custom HTML equivalents.
Nate Beaty
CC BY-SA 4.0
2020-06-03T08:39:00.300Z
2020-06-03T08:39:00.300Z
James Smith
<p>In my organization many of the employees believe the user activation email sent out by Craft is spam.  How do I change the email text and possibly add an image, like our company logo, to the email?</p>

<craft3><users><emails>
How to change the Craft 3 activation email?
# How to change the Craft 3 activation email?

(Asked by: username_0 on 2020-06-02)

In my organization many of the employees believe the user activation email sent out by Craft is spam. How do I change the email text and possibly add an image, like our company logo, to the email?

**Tags:** craft3, users, emails

---

## 1 answers

### Answer by username_1 on 2020-06-03. Score: 4

Under Settings > Email there is a field called "HTML Email Template" which you can use to point to a single template that handles all of the system emails. It's not very obvious from the Craft UI, but you can use that single template as a routing mechanism for including per-email templates using the variable emailKey which is available in the template. Your routing template could look like this:
{# Craft has four predefined email keys:

    account_activation
    verify_new_email
    forgot_password
    test_email

... route to them here, or fallback to default
#}

{% include [
    '_emails/' ~ emailKey ?? null,
    '_emails/default'
] %}

You'd then have another template called account_activation.twig where you can go wild with whatever modifications you like. Each email also has a link variable available in the template to output the link to whatever it is.

> **Comments:**
> **username_2**: This works great for HTML emails, but I noticed the plain text component of the email is still using the system messaging (easy to spot if using MailHog in development). Any idea how to target updating the text version also?  
> **username_1**: great question, let me know here if you find out a way!  
> **username_2**: For now I just ended up editing the text message in Utilities > System Messages, so they at least match up roughly with my custom HTML equivalents.  

---

