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?

1 Answer 1


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:


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

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

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.

  • 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
    Apr 28 at 18:11
  • great question, let me know here if you find out a way! Apr 29 at 16:19

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.