---
title: Configuring e-mail notifications for messages
---

> 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).

Users can be notified about new messages received via the **Messages** application by means of notification e-mails. The e-mails are based on the **Messaging - Notification email** [e-mail template](https://docs.kentico.com/k8/configuring-kentico/managing-e-mail-templates.md).

For this to work, the target e-mail address must be filled into a special field in the user settings. This can be done in one of the following locations:

- On the live site, via the **My profile** web part **-> Personal settings -> Messaging notification e-mail** field.
- Users with access to the system's user interface can enter the e-mail in the **My desk -> My profile ->** **Messaging notification e-mail** field.
- Users with the Global administrator [privilege level](https://docs.kentico.com/k8/managing-users/user-management.md) can enter the notification e-mail for each user in **Users -> Edit () user -> Settings -> Messaging notification e-mail** field.

When the e-mail address is entered into the field, a notification e-mail is sent to the address whenever the user receives a new message. This does not apply to messages received from users in the recipient's **Ignore list**.

> **Note:** Your instance of Kentico must be configured to use an SMTP server in order for e-mails to be sent, as described in [Configuring SMTP servers](https://docs.kentico.com/k8/configuring-kentico/configuring-smtp-servers.md).

### Macros in messaging e-mail template

In the text of the **Messaging - Notification email** template, you can access the following specific objects and their properties (e.g. _{% Sender.UserName %}_) using context macros to include dynamic values:

- **{% Sender %}** - _UserInfo_ object of the message sender.
- **{% Recipient %}** - _UserInfo_ object of the message recipient.
- **{% Message %}** - _MessageInfo_ object of the message.

Besides these special ones, you can also use all other standard macro expressions in the templates. See [Macro expressions](https://docs.kentico.com/k8/macro-expressions.md) for more information about macro expressions in Kentico.

### Related settings

In **Settings -> Community -> Messaging**, you can find the following settings related to the notification e-mails:

- **Messaging sender e-mail** - e-mail address that will be used as the sender address (_From_ field) of the notification e-mails.
- **Messaging e-mail subject** - entered text will be used as content of the _Subject_ field of notification e-mails.

![Configuring messaging-related settings](https://docs.kentico.com/docsassets/k8/configuring-e-mail-notifications-for-messages/configuring_messaging_settings.png "Configuring messaging-related settings")
