Skip to main content

T7. Emails not sending

What this page helps you do​

Debug common email delivery problems.

Why it matters​

Broken emails quietly break onboarding, password reset, and core app flows.

You should already have​

  • an email feature

Skip this page if​

  • the app does not send email

What to do​

  • check API keys and environment settings
  • check sending logs and provider dashboard
  • test with a real inbox you control

Treat email as a core product path if users depend on it.

Common mistakes​

  • testing only in local mode
  • assuming provider acceptance means inbox delivery
  • forgetting rate limits and retries

Next step​

Go to B9. Need background jobs if email sending happens asynchronously.

Advanced notes​

TODO for contributors: add a beginner-friendly email debugging checklist.