[Yandex Cloud documentation](../../../index.md) > [Yandex DataLens](../../index.md) > Dashboards > Mailing lists

# Mailing lists


You can set up a mailing list for your dashboard. Recipients will be getting emails with links to the dashboard and chart states specified in the mailing list settings. You can set up the dashboard selector states, schedule, chart sizes, and other parameters. Mailing lists are available for the current dashboard [version](../../dashboard/versioning.md) only.

{% note info %}

* Mailing lists are only available for dashboards located in [workbooks](../../workbooks-collections/index.md).
* A user with the `datalens.admin` role can add or update a mailing list.

{% endnote %}

To add a mailing list for your dashboard:

1. In the left-hand panel, click ![image](../../../_assets/console-icons/layout-cells-large.svg) **Dashboards** and select the dashboard you need. If you do not have a dashboard, [create one](create.md).
1. Click ![image](../../../_assets/console-icons/envelope.svg) at the top of the screen.
1. Specify the mailing list settings:

   * Mailing list name:
   
     1. Next to the **New mailing list** field, click ![image](../../../_assets/console-icons/pencil.svg).
     1. Enter a mailing list name to display in the email header and subject line.

        Choose the name as per these requirements:

          * It starts and ends with an upper-case or lower-case Latin or Russian letter, number, or one of these characters: `_`, `@`, `(`, `)`, or`%`.
          * The remaining characters can be upper-case or lower-case Latin or Russian letters, numbers, spaces, or the following characters: `_`, `@`, `(`, `)`, `%`, `.`, `,`, `:`, `;`, `'`, `|`, `-`, `–`, `—`, `−`, `$`, `*`, and `&`.

     1. Optionally, enter a description for the mailing list.
     1. Click **Save**.

   * In the **What** step, set the email content:

     * Screenshot size. Valid values:
       
       * Width: `360` to `1920` px.
       * Height: `400` to `6000` px. Use the `Auto` option for automatic height adjustment so that all charts from the dashboard tab fit in the screenshot.

     * Dashboard state. By default, the state of the first dashboard tab is already included in the mailing list content. Correct it if required. You can send multiple dashboard states in a single mailing list. To add another state, click **Add**.

       * Specify the tab and filters for the screenshot:
         
         * Click ![image](../../../_assets/console-icons/pencil.svg) **Edit**. In the window that opens, go to the relevant dashboard tab, configure the filters, and click **Done**.
         * Click ![image](../../../_assets/console-icons/eye.svg) **Preview** to view the screenshot.
         * Click ![image](../../../_assets/console-icons/arrow-up-right-from-square.svg) to open the current dashboard in a new tab.

       * To change the state title, click ![image](../../../_assets/console-icons/pencil.svg).
       
       {% note info %}

       * Update the state if you change selectors or dataset fields.

       {% endnote %}

     After saving the mailing list, you can edit the email content in the **Content** tab.

     {% cut "Mailing list email content" %}

     ![maillist-content](../../../_assets/datalens/dashboard/maillist-content.png =687x436)
   
     {% endcut %}

   * Under **When**, specify the delivery settings:

     * **Trigger**: Set the event to trigger email delivery. Currently, mailing lists support scheduled delivery. Delivery triggered by alerts or dashboard updates will be available soon.

      {% list tabs %}

      - Schedule

        Set the email frequency:

        {% list tabs %}
        
        - Day

          Emails will be sent once a day. Specify the mailing time in the current time zone.

        - Week

          Select the days of the week and set the mailing time in the current time zone.

        - Month

          Specify the day of the month and time in the current time zone.

        {% endlist %}

      {% endlist %}

     After saving the mailing list, you can edit its delivery settings in the **Delivery** tab.

     {% cut "Mailing list email delivery" %}

     ![maillist-sending](../../../_assets/datalens/dashboard/maillist-sending.png =687x436)
   
     {% endcut %}

   * Under **Email to**, specify the recipients.

     {% note info %}

     * To receive the emails, a user must have an active seat.
     * If there are no recipients with an active seat, no emails will be sent.

     {% endnote %}

     After saving the mailing list, you can edit the recipients in the **Recipients** tab.

     {% cut "Mailing list recipients" %}

     ![maillist-recipients](../../../_assets/datalens/dashboard/maillist-recipients.png =687x436)
   
     {% endcut %}

   * In the **History** tab, you can view the mailing list history including dates, times, and delivery status. You can access history after saving the mailing list.

     {% cut "Mailing list history" %}

     ![maillist-history](../../../_assets/datalens/dashboard/maillist-history.png =687x436)
   
     {% endcut %}

1. To add multiple mailing lists for your dashboard, click ![image](../../../_assets/console-icons/plus.svg) at the top left of the **Dashboard mailings** window and repeat Step 3.
1. Click **Save**.

After you add a mailing list, it becomes `Active`, and the system starts sending emails to the specified recipients according to the delivery settings.

Each recipient will receive the mailing list email:

* The subject displays the mailing list name.
* Attachment: Dashboard screenshots in this format: `<mailing_list_name> - <tab_name> - <send_date_and_time>.png`.
* The email contents display:
  
  * State title.
  * Dashboard screenshots.
  * Name of the dashboard used to create the mailing list and its link.
  * Link to unsubscribe from the mailing list.
  * Links to DataLens guides and Yandex Cloud services.

  {% cut "Mailing list email contents" %}

  ![maillist-attachment](../../../_assets/datalens/dashboard/maillist-attachment.png =450x1378)

  {% endcut %}

## Managing mailing lists {#maillist-operations}

You can rename or delete a mailing list, change its settings, pause or resume deliveries, subscribe or unsubscribe from a list, or send an email immediately:

1. In the left-hand panel, click ![image](../../../_assets/console-icons/layout-cells-large.svg) **Dashboards** and select the dashboard you need.
1. Click ![image](../../../_assets/console-icons/envelope.svg) at the top of the screen.
1. In the list on the left, select the mailing list. You can search by name or sort mailing lists by status.
1. Proceed with the relevant action:

   * Update settings. Go to the relevant tab and update the settings as follows:
     
     * Content: Specify which tabs with which filters should be included in the screenshots sent in the mailing list.
     * Sending: Specify the delivery settings.
     * Recipients: Specify the recipients.
     * History: View the mailing list history including dates, times, and delivery status.

   * Send an email immediately. At the bottom of the mailing lists window, click ![image](../../../_assets/console-icons/envelope.svg) **Send** and select who will receive the email: `Only me` or `All recipients`.

   * Subscribe or unsubscribe:
     
     * To subscribe to a mailing list, click ![image](../../../_assets/console-icons/bell.svg) **Subscribe** at the top below the mailing list name, or click ![image](../../../_assets/console-icons/ellipsis.svg) → ![image](../../../_assets/console-icons/bell.svg) **Subscribe**.
     * To unsubscribe from a mailing list, click ![image](../../../_assets/console-icons/bell.svg) **Subscribed** at the top below the mailing list name, or click ![image](../../../_assets/console-icons/ellipsis.svg) → ![image](../../../_assets/console-icons/bell-slash.svg) **Unsubscribe**.

   * Pause or resume deliveries:
     
     * To pause a mailing list, click ![image](../../../_assets/console-icons/circle-play.svg) **Active** at the top below the mailing list name, or click ![image](../../../_assets/console-icons/ellipsis.svg) → ![image](../../../_assets/console-icons/pause.svg) **Pause**. The mailing list status will switch to `Paused`, and email deliveries will be suspended.
     * To activate a mailing list, click ![image](../../../_assets/console-icons/circle-pause.svg) **Paused** at the top below the mailing list name, or click ![image](../../../_assets/console-icons/ellipsis.svg) → ![image](../../../_assets/console-icons/play.svg) **Resume**. The mailing list status will switch to `Active`, and email deliveries will resume according to the mailing list settings.

   * Rename. To rename a mailing list, click ![image](../../../_assets/console-icons/ellipsis.svg) at the top to the right of the mailing list name, or click ![image](../../../_assets/console-icons/ellipsis.svg) → ![image](../../../_assets/console-icons/pencil.svg) **Rename** below its name. In the window that opens, enter the mailing list name and description and click **Save**.
   * Delete. To delete a mailing list, click ![image](../../../_assets/console-icons/ellipsis.svg) → ![image](../../../_assets/console-icons/trash-bin.svg) **Delete** at the top below the mailing list name.