// troubleshooting guide · metabase

Metabase Not Sending Emails or Alerts

Status
Workaround available
platforms:
Self-hosted; Metabase Cloud with custom SMTP (Pro)
updated:
November 16, 2026
reports:
3
Method
how we research
Share

RUNBOOK · metabase/not-sending-email4 FIXES

// quick answer

Most cases are wrong SMTP settings or a mail service that blocks the sender or recipient domain. Send a test email from Admin > Email, read the error in Admin > Tools > Logs, and check spam and DKIM if mail is sent but not received.

Most likely fix: Send a test email

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Send a test email

    1. 01Go to Admin > Email
    2. 02Check host, port, security, username and password
    3. 03Click Save changes, then Send test email
    Did this fix it?
  2. FIX 2Read the error

    1. 01Go to Admin > Tools > Logs and look for SMTP errors
    2. 02Test the same credentials in another email client
    Did this fix it?
  3. FIX 3Check the delivery service

    1. 01Allow sending to the recipients' domain
    2. 02Verify the from address you use in Metabase
    3. 03Turn off test or sandbox mode
    4. 04Check the service's outbound queue or logs
    Did this fix it?
  4. FIX 4Fix deliverability

    1. 01Check spam folders and forwarding rules
    2. 02Set up DKIM for your sending domain
    Did this fix it?

SANDBOX · metabase RUNS IN YOUR BROWSER

Try it: browse a sample shop and watch visitors, funnels and live data arrive

A hands-on Metabase-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.

Symptoms

Alerts, dashboard subscriptions or password-reset emails never arrive, or the test email fails.

Why it happens

  • C-01Wrong SMTP host, port, user or password
  • C-02Mail service rejects the from address or recipient domain
  • C-03Delivery service in test or sandbox mode
  • C-04Emails landing in spam or caught by forwarding rules
  • C-05No DKIM signing when sender and recipient providers differ

// this guide also covers

  • metabase not sending email
  • metabase alerts not working
  • metabase smtp settings
  • metabase subscription email not received

Still not working?

If Metabase keeps failing, you're not alone. See every Metabase problem users report or the alternatives people switch to.

Done fighting Metabase? Our small team builds your own Metabase alternative, or any software you need: web, mobile, games, desktop. Price agreed together.

Talk to us

Watch Metabase Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All notifications, reminders & messages not sending guides →

Other Metabase errors

All 14 Metabase errors and fixes →