# Add custom email templates Email templates are used within the [Send Email](https://docs.appfarm.io/library/action-nodes/send-email) action node and when customizing the default authentication emails. We have provided some example templates that leverage best practices to help you quickly start sending customized emails. The templates are written using [MJML](https://mjml.io/). MJML is a markup language and framework for easily generating responsive emails that render on most email clients. When working with MJML you need to copy the HTML generated by MJML into Appfarm Create, and not the MJML code itself. Plain text versions of each email must also be included as a fallback option. Email deliverability is an expansive topic that won't be explored here, but you should be familiar with some of the key principles before you begin creating your own templates or heavily modifying the examples. ## Authentication It is possible to customize the default authentication emails that are sent to users by Appfarm when they initiate a login request. The examples below are based on the default emails sent by Appfarm. These make a great starting point for customization, particularly if you simply wish to modify the text. The parameters surrounded by `{{double braces}}` will be automatically populated by Appfarm when an email is sent. Text surrounded by `[[square brackets]]` should be edited to suit your solution. ### Welcome The welcome email can be sent when a user is added to a solution via the Create User Account action. [Open template on mjml.io to edit and view HTML](https://mjml.io/try-it-live/p5YP39BP6). {% code title="MJML" %} ```markup

Welcome to [[SOLUTION NAME]]

.button:hover a { background-color: #286db0 !important; }

Hi {{firstName}},

You have been added as a user for [[SOLUTION NAME]].

Click the button below to sign in.

Or, copy and paste this link into your browser:
{{loginLink}}

This email was sent by Appfarm on behalf of [[SOLUTION NAME]]. If you did not request this email, please reply and let us know.

[[COMPANY NAME]]
[[STREET ADDRESS]]
[[POSTCODE]] [[CITY]]
[[COUNTRY]]

``` {% endcode %} {% code title="Plain text" %} ``` Hi {{firstName}}, You have been added as a user for [[SOLUTION NAME]]. Use the following link to sign in. {{loginLink}} This email was sent by Appfarm on behalf of [[SOLUTION NAME]]. If you did not request this email, please let us know by replying to this email. ------ [[COMPANY NAME]] [[STREET ADDRESS]] [[POSTCODE]] [[CITY]] [[COUNTRY]] ``` {% endcode %} ### Login link The login link email is sent when a user requests a login link to log in to an app. [Open template on mjml.io to edit and view HTML](https://mjml.io/try-it-live/nPUJrRZGY). {% code title="MJML" %} ```markup

Click this link to sign in.

.button:hover a { background-color: #286db0 !important; }

Hi {{firstName}},

Please click the button below to sign in to [[SOLUTION NAME]]. The link will expire in 5 minutes.

Or, copy and paste this link into your browser:
{{loginLink}}

This email was sent by Appfarm on behalf of [[SOLUTION NAME]]. If you did not request this email, please reply and let us know.

[[COMPANY NAME]]
[[STREET ADDRESS]]
[[POSTCODE]] [[CITY]]
[[COUNTRY]]

``` {% endcode %} {% code title="Plain text" %} ``` Hi {{firstName}}, Please use the following link to log in to [[SOLUTION NAME]]. The link will expire in 5 minutes. {{loginLink}} This email was sent by Appfarm on behalf of [[SOLUTION NAME]]. If you did not request this email, please let us know by replying to this email. ------ [[COMPANY NAME]] [[STREET ADDRESS]] [[POSTCODE]] [[CITY]] [[COUNTRY]] ``` {% endcode %} ### Access code (one-time password) The access code (one-time password) email is sent when a user requests an access code to log in to an app. [Open template on mjml.io to edit and view HTML](https://mjml.io/try-it-live/y2xsWsZ1m). {% code title="MJML" %} ```markup

Use access code {{oneTimePassword}}.

Hi {{firstName}},

Please use the following access code to sign in to [[SOLUTION NAME]]. The access code will expire in 5 minutes.

This email was sent by Appfarm on behalf of [[SOLUTION/COMPANY NAME]]. If you did not request this email, please reply and let us know.

[[COMPANY NAME]]
[[STREET ADDRESS]]
[[POSTCODE]] [[CITY]]
[[COUNTRY]]

``` {% endcode %} {% code title="Plain text" %} ``` Hi {{firstName}}, Please use the following access code to log in to [[SOLUTION NAME]]. The access code will expire in 5 minutes. {{oneTimePassword}} This email was sent by Appfarm on behalf of [[SOLUTION NAME]]. If you did not request this email, please let us know by replying to this email. ------ [[COMPANY NAME]] [[STREET ADDRESS]] [[POSTCODE]] [[CITY]] [[COUNTRY]] ``` {% endcode %} ### Set password The set password email is sent when a user requests to set or reset their password. [Open template on mjml.io to edit and view HTML](https://mjml.io/try-it-live/ErOgcQ7KW). {% code title="MJML" %} ```markup

Set new password for [[SOLUTION NAME]]}

Use this link to set a password.

.button:hover a { background-color: #286db0 !important; }

Hi {{firstName}},

We have received a request to set a new password for your [[SOLUTION NAME]] account {{email}}.

Please click the button below to set a new password. The link will expire in 15 minutes.

Set password

Or, copy and paste this link into your browser:
{{resetLink}}

This email was sent by Appfarm on behalf of [[SOLUTION NAME]]. If you did not request this email, please reply and let us know.

[[COMPANY NAME]]
[[STREET ADDRESS]]
[[POSTCODE]] [[CITY]]
[[COUNTRY]]

``` {% endcode %} {% code title="Plain text" %} ``` Hi {{firstName}}, We have received a request to set a new password for your [[SOLUTION NAME]] account {{email}}. Please use the following link to set a new password. The link will expire in 15 minutes. {{resetLink}} This email was sent by Appfarm on behalf of [[SOLUTION NAME]]. If you did not request this email, please let us know by replying to this email. ------ [[COMPANY NAME]] [[STREET ADDRESS]] [[POSTCODE]] [[CITY]] [[COUNTRY]] ``` {% endcode %} ## Order confirmation This generic order confirmation is an example of an email that can be customized for use in the [Send Email](https://docs.appfarm.io/library/action-nodes/send-email) action node. **Note:** This is just a design template. If you wish to iterate over an object when the email is sent, for example to display multiple order lines, you will need to edit the generated HTML accordingly. [Open template on mjml.io to edit and view HTML](https://mjml.io/try-it-live/KauujFBxd). {% code title="MJML" %} ```markup

Order confirmation

Your order #${order.orderNumber} is confirmed.

.button:hover a { background-color: #4c1d95 !important; }

Hi ${firstName},

Your order is confirmed. Please find a summary of your order below.

Order #${order.orderNumber}

${customer.name}
${customer.street}
${customer.postcode} ${customer.city}
${customer.country}

Order received: ${order.orderDate}
Payment type: ${order.paymentType}
Terms: ${order.paymentTerms}

Serial # Quantity Product Price ${orderLine.serialNumber} ${orderLine.quantity} ${orderLine.productName} ${orderLine.price} Total ${total}

Check order status

Appfarm AS
Universitetsgata 2
0164 Oslo
Norway

``` {% endcode %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.appfarm.io/how-to/themes-and-styling/add-custom-email-templates.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.