home User Guide Getting Started Help Center Documentation Community Training Certification
Looker keyboard_arrow_down
language keyboard_arrow_down
Looker documentation will be moving to cloud.google.com in mid-2022!
All the information you rely on will be migrated and all docs.looker.com URLs will be redirected to the appropriate page.

The SMTP page (SMTP stands for Simple Mail Transfer Protocol) in the Platform section of the Admin menu lets you configure your email settings. Looker instances send emails in many situations, including new user notifications, password resets, and administrative notifications, as well as when users deliver content such as legacy dashboards, dashboards, and Looks.

Mail settings

In Looker’s Admin panel, choose SMTP to see and change your instance’s SMTP settings. You can use the default mail settings to take advantage of Looker’s email service, without the need for additional configuration.

To use a different email service, select Use custom mail settings. Looker enables access to the email service fields:

Custom mail settings can be configured for SMTP servers that support the PLAIN and LOGIN authentication protocols.

Enter the appropriate values for your email service’s SMTP settings:

Once you have entered your SMTP settings, click the Save button to save your configuration. You can also test your settings, or refresh the page to see if your configuration has any errors.

If you are using custom mail settings for SMTP, add Looker’s IP addresses to your SMTP server’s IP allowlist so that your SMTP server will allow inbound traffic from Looker.

Looker restricts how often Looker admins can save or test the SMTP settings to prevent using this feature to scan for open ports.

Testing custom email settings

To test your custom email setup, use the Send Test Email button. Looker will attempt to send a test email to the user who pressed the button; it does not send a test email to everyone. Here is a test email that uses the SMTP settings shown above:

Looker restricts how often Looker admins can test the SMTP settings to prevent using this feature to scan for open ports.

SMTP error messages

If there are any problems with your SMTP configuration, Looker alerts all admins in three places:

  1. With a warning icon next to the Admin menu
  2. With a warning message on the SMTP page itself
  3. With a warning icon next to the SMTP listing in the Admin sidebar

These errors are visible to all admins on your Looker instance. You can check for errors immediately by refreshing the page after saving custom mail settings.

Errors related to custom email settings tests appear below the Save and Send Test Email buttons at the bottom of the SMTP page.