---
title: Form notification emails
---

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

The Forms application allows you to send two types of emails automatically when a new record is added:

- [Notification email](#notification-emails) – emails notifying the person responsible for form data management (content editor, administrator, etc.) about new submitted records.
- [Autoresponder](https://docs.kentico.com/13/managing-website-content/forms/form-autoresponder-emails.md) – email to the person who submitted the new record, typically confirming that the record has been received and will be processed.

When a user submits the form on the live site, the emails are sent according to configuration made on the **Email notification** and **Autoresponder** tabs of the form's editing interface. When you add a form record via the administration interface, you can decide whether to send the emails (as described in [Managing form data](https://docs.kentico.com/13/managing-website-content/forms/managing-form-data.md)).

## Notification emails

You can configure the notification emails on the **Email notification** tab of a form's editing interface:

1. Open the **Forms** application.
2. Edit () a form.
3. Switch to the **Email notification** tab.
4. Select the **Send form data to email** option if you wish to include the submitted form data within the notification email.
5. Define the settings:
   - **Sender email** – the email address from which the notifications are sent (e.g. a general sender address with your website's email domain, such as _form-notifier@company.com_).
   - **Recipient emails** – email addresses where notification emails are sent. You can specify multiple addresses separated by semicolons. For example, add the addresses of staff members who are responsible for processing of submitted form records.
   - **Subject** – subject of the notification emails.
   - **Attach uploaded documents** – enable this option if you want to attach files submitted via the form (if there are any) to the notification emails.
   - **Use custom layout**:
     - If disabled, the body of the notification emails contains all field names with the entered values, each on a single line.
     - If enabled, you can define a custom layout for the notifications in the text area displayed below the check box. See [Custom email layout](#custom-email-layout).
6. Click **Save**.

### Custom email layout

When using a custom notification email layout, you can add the labels or values of the form's fields:

1. Select a field in the **Available fields** list box.
2. Click **Insert label** or **Insert value**.

   - For fields based on selector form components (e.g., _Drop-down list_ or _Radio buttons_), use [Form data macros](https://docs.kentico.com/13/managing-website-content/forms/using-macros-with-forms.md) to insert the value of the field. For example: _{%DropDownField%}_

To create a starting point for the layout, click **Generate table layout**, which adds all of the form's fields organized in a basic HTML table.

> **Note:** **Security**
>
> Visitors can potentially submit form values containing malicious HTML values. When using a custom layout, form notification emails do not encode field values by default. This can lead to potential HTML injection if the recipient’s email client is configured to display HTML content. If you wish to encode the values of submitted form fields in notification emails, add the **CMSBizFormMailEncodeFields** configuration key to your project’s _appsettings.json_ or _web.config_ file and set its value to _true_. Add the key to both your live site and administration projects.

> **Info:** **Macros in form emails**
>
> You can also insert dynamic values into the form notification settings or layout by adding macros. See [Using macros with forms](https://docs.kentico.com/13/managing-website-content/forms/using-macros-with-forms.md) for details.
>
> Only basic macros are supported, such as the form's data fields or localization expressions. Macros that retrieve values from various types of contexts may not resolve correctly when the form is submitted on the live site.