--- title: Managing email templates related: - https://docs.kentico.com/k9/managing-users/sending-emails.md - https://docs.kentico.com/k9/developing-websites/loading-and-displaying-data-on-websites/writing-transformations/using-transformations-in-macro-expressions.md --- > Agent instructions: > **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown. > > - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version. > - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt). Kentico sends automatic system emails for various purposes, for example workflow notifications. The content of such emails is determined by templates according to the type of the given email. Many Kentico features send emails based on predefined templates that are included in the default installation. To edit the templates, open the **Email templates** application. Editing templates allows you to alter the emails sent by the system to match the required design and/or language. There are two types of email templates: - **Global** - only users with the Global administrator [privilege level](https://docs.kentico.com/k9/managing-users/user-management.md) can manage global email templates. Choose the **(global)** option in the **Site** selector. - **Site-specific** - allow you to override the global templates for specific websites. You need to select the appropriate **Site** and create a new template with a **Code name** that matches the corresponding global template. The system only contains global templates by default. When editing email templates, the following properties are available: | Property | Description | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Display name | The name of the template displayed in the administration interface. | | Code name | Serves as a unique identifier of the email template (for example in the API). | | Email type | Identifies the type of functionality to which the template is related. This can be used to categorize and filter email templates. | | From | Email address used as the sender (From) address of the email. | | Cc | Email addresses of copy recipients. | | Bcc | Email addresses of blind copy recipients (receive a copy of the email, but cannot see the addresses of other recipients in the mail). | | Subject | Subject of the email. | | HTML version | Defines the content that is used for the template when sending emails in HTML format. Supports all standard HTML tags and syntax (tables etc.).
You can select the preferred format using the **Settings -> System -> E****mails -> E****mail format** setting. | | Plain text version | Plain text version of the email template. | Example of the HTML version of a template: ```html

This is an automatic notification sent by Kentico. The following page is waiting for your approval. Please sign in to the Kentico administration interface and approve it.

Page: {%documentname%} {% ifEmpty(DocumentPreviewUrl, "", "(preview)")|(encode)false%}
Last approved by: {%approvedby%}
Last approved when: {%approvedwhen%}
Original step: {%originalstepname%}
Current step: {%currentstepname%}
Comment:
{%comment%}

``` Most templates contain [macro expressions](https://docs.kentico.com/k9/macro-expressions.md) (such as {% currentstepname %}), which the system resolves dynamically when sending the emails. The use of macros is necessary to ensure that individual emails contain information relevant to the situation that caused the email to be sent. You can add macros into fields by clicking **Insert macro** () or write the required expressions manually. If you wish to display data loaded via a macro in a specific format, you can apply [transformations](https://docs.kentico.com/k9/developing-websites/loading-and-displaying-data-on-websites/writing-transformations.md). See [Using transformations in macro expressions](https://docs.kentico.com/k9/developing-websites/loading-and-displaying-data-on-websites/writing-transformations/using-transformations-in-macro-expressions.md) for more information. > **Tip:** You can attach files to an email template through the **Attachments** button in the header of the template editing page. The attachments are included when the system sends out emails based on the given template. Clicking the button opens a dialog where you can manage the attachments.