// 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
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
FIX 1Send a test email
- 01Go to Admin > Email
- 02Check host, port, security, username and password
- 03Click Save changes, then Send test email
Did this fix it?FIX 2Read the error
- 01Go to Admin > Tools > Logs and look for SMTP errors
- 02Test the same credentials in another email client
Did this fix it?FIX 3Check the delivery service
- 01Allow sending to the recipients' domain
- 02Verify the from address you use in Metabase
- 03Turn off test or sandbox mode
- 04Check the service's outbound queue or logs
Did this fix it?FIX 4Fix deliverability
- 01Check spam folders and forwarding rules
- 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 usThe same problem in other apps
All notifications, reminders & messages not sending guides →
Superset Alerts and Reports Not Sending Emails (Apache Superset)
Looker Studio Scheduled Email Not Sending (Looker Studio)
Other Metabase errors
- Metabase Dashboard Slow or Not Loading
- Metabase 'Your Question Took Too Long' Error
- Metabase Not Syncing New Tables or Columns
- Metabase Filter Dropdown Not Showing Values
- Metabase Linked Filters Not Working
- Metabase Can't Connect to Database
- Metabase Tables Not Showing
- Metabase Dates and Times Wrong (Timezone Off)