---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
alternate:
  - https://yandex.ru/support/forms/en/send-mail.md
  - https://yandex.ru/support/forms/ru/send-mail.md
  - href: en/send-mail.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/forms/en/llms.txt

# Send an email

You can integrate your form with Yandex Mail so that a notification is sent automatically when the user fills out the form.

## Add an email notification {#setup}

1. Select the desired form and open the **Integration** tab.

1. Select a [group of actions](https://yandex.ru/support/forms/en/notifications.md#add-integration) for which you want to set up sending emails.

   By default, each new form has a pre-created **Mail** action.

    - If you want to use the existing email integration, enable the **Mail** action.

        ![](_assets/mail-integration.png =700x){.border-grey}

    - If you want to add a new action and configure it, click ![](_assets/mail-notification-new.png) **Mail** at the bottom of the group.

1. Configure the email notification parameters. [Fields in the Mail action settings](#fields)

1. To attach a file from your computer to the email, click **Attach file**.

   To attach the files that the user sent in response to the form to your email, select questions of the <q>File</q> type from the **Attach files from question answers** list.</p>


    {% note info "" %}

   The maximum total size of the email is 9 MB. This includes technical information, the message body, and the attached files.

   {% endnote %}


1. To display a message informing the user that an email was sent after they filled out the form, enable the **Show messages about the results of actions** option under the action name.

1. Click **Save**.


## How to fill in the action settings fields {#fields}

* **To**: Email address to send the notification to. You can list multiple addresses separated by commas, or set a variable.

    - To send a notification to the form creator's email,  select the **Form creator's email** variable.

    - To send a notification to the Yandex email account the user was logged in to when filling out the form, select the **Email** variable. This option is only available to Yandex Forms for business users.

    - To send a notification to the address the user entered when answering a question, add the **Question answer** variable and select the <q>Email</q> question type.



* **Sender**: Sender name you want the recipient to see.

* **Send response to**: Email address the recipient can send responses to. If not specified, your respondents will not be able to reach you by email.

* **Subject**: Email subject.

* **Text**: Email text.

* **Headers**: If necessary, add service email headers:

   - Click ![](_assets/svg/add.svg)</svg> **Add header**.
   - Specify a name and value for each header.

      The header name must begin with the prefix `X-` and must not contain Cyrillic characters. Otherwise, the header will be ignored. Header name example: `X-Form`.

    - You can use [variables](https://yandex.ru/support/forms/en/vars.md) as parameter values. To do this, click ![](_assets/svg/add.svg)</svg> on the right of the field. If you're using a variable, enable **Send if value is set**.

* To insert an answer to a question or other form data in any field:

   - Select the field and click ![](_assets/svg/add.svg)</svg> on the right.

   - Select a [variable](https://yandex.ru/support/forms/en/vars.md) from the list to add to the field. For example, you can add a variable to address the user by their name or to include their [test results](https://yandex.ru/support/forms/en/tests.md) in the email.

   ![](_assets/mail-var-example-new.png =600x){.border-grey}

## Configure multiple email notifications {#multiple-notifications}

To send multiple email notifications at once, add new actions using the ![](_assets/mail-notification-new.png) **Mail** button at the bottom of the action group.

If you want notifications to only be sent to users who gave certain answers, [set your conditions](https://yandex.ru/support/forms/en/notifications.md#conditions).

> Sample notification for a form with a questionnaire for job applicants. Once the form is filled out, the survey answers are sent to the HR department's email address.
>
> ![](_assets/email-example-new.png =700x){.border-grey}

## Troubleshooting {#troubleshooting}

If you set up email notifications but are not getting emails after filling out the form, check your **Spam** folder and see if there are errors when sending emails.

### Check your **Spam** folder {#error-spam}

If you are not receiving email notifications, check your <q>Spam</q> folder. If emails from Yandex Forms were sent to the **Spam** folder, mark them as <q>Not spam</q>.

 If you use your own mail server, <q>whitelist</q> the sender addresses: `<form_ID>@forms.yandex.com` and `sndr.bnc@yandex.ru`.

### Check the email text {#error-text}

The mail server can block an email if its text is missing or looks like spam. Fill out or edit the email text.

### Check the size of attachments {#error-size}

If a file attached to an email is too big, the mail server will not be able to send it. When this happens, the following error message will appear:

```
Error class: EmailMaxSizeExceededError
Error message: Total file size must be less than 9 MB.
```


   {% note info "" %}

   The maximum total size of the email is 9 MB. This includes technical information, the message body, and the attached files.

   {% endnote %}

To avoid this error, limit the maximum size of files that users can attach to forms. To do this, in the **File** question settings, set the [maximum total file size](https://yandex.ru/support/forms/en/blocks-ref/file.md#max-size) to no more than 8 MB.

If you need users to be able to attach large files to their answers, use **Share link** or **Short text** questions. This way, users will be able to link files uploaded to an external hosting.

### Check for integration errors {#error-history}

<!-- source: en/_includes/inregration-errors.md -->
To check for errors that occur during the form integration:

1. Open the form where the integration is incomplete or doesn't work as expected.

1. Go to the **Integrations** tab and click **Completed integrations**.

1. Check the list for error messages related to your integration. 

1. After resolving the problem, try [creating an issue again](https://yandex.ru/support/forms/en/notifications-history.md#status).

1. If the problem persists, [contact support](https://yandex.ru/support/forms/en/feedback.md).
<!-- endsource: en/_includes/inregration-errors.md -->

### If there are no spam notifications or error messages {#error-support}

If you have no notifications in the <q>Spam</q> folder or errors in the **Integration** tab, the email may be blocked by the recipient's mail server. To find out why the email is blocked:

1. Open the form with notification issues and click **Integration** at the top of the page.

1. In the email notification settings, go to the **Send response to** field and enter your personal or corporate email.

1. The next time the mail server blocks a notification from the form, an error message will be sent to the email that you specified. Copy the message text.

1. [Contact Yandex Forms support](https://yandex.ru/support/forms/en/feedback.md) and include the error message that you received.

<!-- source: en/_assets/style.md -->

<!-- endsource: en/_assets/style.md -->