Menu
Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Alerts and IRMbreadcrumb arrow Alertingbreadcrumb arrow Configure notificationsbreadcrumb arrow Configure contact pointsbreadcrumb arrow Email
Grafana Cloud Enterprise Open source

Configure email for alert notifications

Use the email integration to send alert notifications to one or more addresses.

You can customize the subject and main section of the email body. By default, the subject and body are generated from the alert data included in the notification.

Before you begin

In Grafana OSS, you must configure SMTP settings before you can enable email notifications.

Note

In Grafana Cloud, SMTP configuration is not required.

  1. Open the configuration file. The file is typically named grafana.ini or custom.ini and located in the conf directory of your Grafana installation.

  2. Configure the SMTP settings for your email server in the [smtp] section.

  3. Save your changes and restart Grafana.

  4. Test email notifications by creating a contact point.

Configure Email for a contact point

To create a contact point with a email integration, complete the following steps.

  1. Navigate to Alerts & IRM -> Alerting -> Contact points.
  2. Click + Create contact point.
  3. Enter a name for the contact point.
  4. From the Integration list, select Email.
  5. Set up the required settings for your Email configuration.
  6. Click Save contact point.

For more details on contact points, including how to test them and enable notifications, refer to Configure contact points.

Email settings

OptionDescription
AddressesThe list of email addresses to send the notifications. Email addresses are case sensitive.

Optional settings

OptionDescription
Single emailSend a single email to all email addresses rather than individual emails.

Optional settings using templates

Note

You can customize the email subject and main section of the email body, but you can’t edit HTML or CSS for visual changes.

In Grafana OSS and Enterprise, you can edit the full email template. However, this is not officially supported because it’s an internal API that may change without prior notice.

OptionDescription
SubjectSets the email subject, replacing the default template. Supports notification templates.
MessageSets the main section of the email body, replacing the default template. Supports notification templates.
Email notification with custom message.
Email notification with custom message.

Optional notification settings

OptionDescription
Disable resolved messageEnable this option to prevent notifications when an alert resolves.