> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getmocha.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Email

> Send emails from your Mocha app

Mocha Email lets your apps send emails — things like welcome messages, password resets, order confirmations, and notifications. It's fully built in, so there's nothing extra to install or set up.

<Frame caption="Watch: Email in Mocha">
  <video controls width="100%" src="https://static.getmocha.com/education-videos/emails.mp4" />
</Frame>

## How it works

Just ask Mocha to add email to your app. Tell it something like "send a welcome email when someone signs up" or "add a password reset flow," and it'll handle the code for you. You can monitor deliveries, opens, bounces, and more from the Email tab in your dashboard.

Want to change how your emails look or what they say? Just prompt. Tell Mocha something like "make the welcome email more colorful" or "add the user's name to the subject line" and it'll update the email for you.

## Testing emails during development

While you're building and previewing your app, emails are automatically sent from `noreply@mail.mocha.app` and can only be delivered to your own account email. This way you won't accidentally email real users while testing.

<Note>
  We're planning to expand this shared Mocha sender for users on our paid tiers in the near future, so you have more flexibility when testing emails during development.
</Note>

Once you publish your app with a verified domain, emails go out from your domain and can reach anyone.

## Connecting a domain

To send emails from your own domain, you need to verify that you own it.

<Steps>
  <Step title="Add your domain">
    Go to **Settings > Domains** and enter your domain name.
  </Step>

  <Step title="Connect DNS records">
    Click **Connect**. Mocha will open a guided setup that walks you through adding two DNS records to your domain. If your registrar supports it, this can be done automatically with a few clicks.
  </Step>

  <Step title="Wait for verification">
    DNS changes usually take a few minutes but can take up to 48 hours depending on your provider. Mocha checks automatically, so you don't need to keep refreshing.
  </Step>
</Steps>

Once verified, your domain is ready to send from.

## Set your sender address

Go to **Settings > Email** to configure the sender address and display name for your emails. This is what recipients will see in their inbox — for example, `noreply@yourdomain.com` from "My App." You'll need a verified domain before you can set a custom sender address.

## Email limits

Your monthly email limit depends on your plan:

| Plan   | Emails per month |
| ------ | ---------------- |
| Free   | 10               |
| Bronze | 500              |
| Silver | 2,500            |
| Gold   | 10,000           |

<Tip>
  If you need higher limits, reach out to [support@getmocha.com](mailto:support@getmocha.com).
</Tip>

Limits reset at the start of each calendar month. You can check your current usage in the Email tab.

## Bounces and suppressions

If an email bounces or a recipient marks it as spam, that address is automatically suppressed. Mocha won't try to send to it again. This protects your domain's reputation and keeps your delivery rates healthy.

You can see all suppressed addresses in the Email tab under **Undelivered messages**.

## Marketing emails

Mocha supports two kinds of email: **transactional** and **marketing**. Transactional emails are triggered by something a user does — like a welcome email when they sign up, or a receipt after a purchase. Marketing emails are ones *you* choose to send — like newsletters, product announcements, or weekly digests.

To set up marketing emails, just ask Mocha to create an email campaign in your app. It'll handle delivery through your existing email configuration, and automatically manages your subscriber list — including unsubscribe handling so you stay compliant.

<Note>
  Broadcast emails count toward your monthly email limit.
</Note>

## Common issues

| What you're seeing                    | What to do                                                                                                        |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| "Monthly email limit exceeded"        | You've used all your emails for this month. Upgrade your plan or wait for the next month.                         |
| Emails only going to your own address | This is normal during development. Publish your app with a verified domain to send to anyone.                     |
| Domain stuck on "Pending"             | DNS changes can take up to 48 hours. If it's been longer, double-check your DNS records are configured correctly. |
| "Recipient is suppressed"             | That address previously bounced or complained. Mocha won't send to it to protect your reputation.                 |
| No sender address configured          | Go to Settings > Email and set a default sender email and name.                                                   |