v0.41 / Troubleshooting Guide / Cant Send Email

Metabase isn’t sending email

You have told Metabase to send email notifications, but:

• the notifications aren’t arriving.

Are the email credentials correct?

Root cause: The host, port, email address, or password may have been set up incorrectly, or the email server’s host and port have been set up incorrectly.

Steps to take:

1. In the Admin Panel, select Email Settings and check the settings.
2. If they seem correct, click Send test email.
3. Verify that the email is delivered to the test account.
4. If the message is not sent or an error message is displayed in Metabase, try to use the same account credentials in another email program and see if they work. If they do, you may have found a bug—please report it.

Is the mail server actually sending the message?

Root cause: Some email delivery services have very specific rules regarding valid “from” addresses, or have test modes that restrict delivery.

Steps to take:

1. Check that your delivery service allows you to send email to the domain you’re trying to get email sent to. (Exactly how to do this depends on the delivery service you’re connecting to.)
2. Make sure you’ve whitelisted the “from” address that you’re using for Metabase.
3. Check the mail server’s logs for any error messages.
4. If you have access to your email delivery service’s outbound queue or a dashboard, check that for errors as well.

Is the mail being sent but not arriving?

Root cause: The message is being sent correctly, but isn’t being received (at least, not where you expect it to be).

Steps to take:

1. Check whether email sent to other accounts is arriving, e.g., are colleagues receiving their notifications?
2. If so, check your spam folder, any forwarding rules you have set up, etc.
3. Check whether you’re using the same email provider as the people who are receiving their messages. If not, the problem might be with deliverability rules—look into signing your emails with DomainKeys Identified Mail (DKIM).