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

# Email deliverability

> Why an email bounces, lands in spam or never goes out, which addresses Boom stops emailing, and what Gmail, Yahoo and Microsoft require from bulk senders.

Deliverability is whether your emails reach the inbox. Boom sends from your
own verified domain, so the reputation that decides it is your domain's: every
bounce and every spam report counts against it. This page covers what Boom
does to protect it, and what's in your hands.

## What happens to each email

Every email ends up in one of these states. Sent emails show in
[message logs](https://docs.useboom.ai/message-logs.md): bounces, spam reports and blocked sends as
**Failed**, with the reason. Skipped emails were never sent, so they show only
in the journey step's results and in journey analytics.

| What happened | What it means | What Boom does |
| - | - | - |
| **Delivered** | The recipient's email server accepted it. It may still land in spam: servers don't say. | Nothing. |
| **Bounced** | The server refused it. A *hard* bounce means the address doesn't exist or never will accept mail; a *soft* bounce is temporary (full inbox, server down, message too large). | A hard bounce stops emails to that address at once. Soft bounces stop them after three in a row. A soft bounce that arrives after the email was delivered (an out-of-office reply, for example) leaves it **Delivered**. |
| **Marked as spam** | The person clicked *Report spam*. | Stops emails to that address for good, and ends the journey run that sent the email. |
| **Blocked by the email provider** | Our sending provider refused to send, because this address caused delivery problems before. | Stops emails to that address. |
| **Skipped** | Boom didn't send it: the person has no email address, is on Do Not Contact, the address is one Boom stopped emailing (below), the address unsubscribed from your marketing email (marketing journeys only; see [Unsubscribes](#unsubscribes)), or the person opted out of marketing email (only when Boom has turned on the marketing-consent check for your organization; see [Journeys](https://docs.useboom.ai/journeys.md)). | The journey continues as if the step ran; its result says why nothing went out. |
| **Not sent** | Boom refused the email before it left: email sending is paused for your organization, your domain's setup isn't finished, or the day's sending limit was reached. | Shows in [message logs](https://docs.useboom.ai/message-logs.md) as **Failed** with the reason. The journey run stops. Bulk sends, such as campaigns, wait for the daily limit instead and go out later. Marketing email (campaigns and journeys) is held while sending is paused: it goes out when sending resumes, or expires unsent after 7 days (48 hours for a journey started by a customer event). |

## Addresses Boom stops emailing

When an address hard-bounces, soft-bounces three times in a row, is reported
as spam, or is blocked by the provider, Boom adds it to your organization's
**undeliverable list**. From then on:

* Journeys, campaigns and transactional messages **skip email** to that
  address. Other channels (WhatsApp, SMS) for the same person keep going,
  unless the person reported spam: that ends the journey run that emailed
  them.
* In the inbox, the reply box tells you why. You can still reply to an address
  that bounced, but the reply may not arrive. You can't reply to one that
  reported your email as spam.

**How an address comes off the list.** Only a delivered email takes an
address off. An address listed after soft bounces (a full inbox, say) comes
off when a later email to it is delivered, for example a reply from your team
in the inbox. A hard-bounced or blocked address usually stays blocked by our
email provider too, so another email won't get through: if you believe the
mailbox works again, contact Boom support. An address that reported spam never
comes off: sending to it again would be sending to someone who said no.

**How it differs from Do Not Contact and unsubscribes.** Do Not Contact is a
person's choice (they asked not to be contacted) and covers every channel. An
email **unsubscribe** covers marketing email only (see below). The
undeliverable list is about the **email address** only: the mailbox doesn't
work, so Boom stops wasting sends on it and keeps your domain's reputation
clean.

## Unsubscribes

When someone uses the unsubscribe link in one of your emails, or their mail
app's unsubscribe button (which may send Boom an unsubscribe email on their
behalf), Boom stops sending them **marketing email** from your
organization. Emails about their orders and account (transactional journeys)
still reach them, and so do your WhatsApp and SMS messages. The confirmation
page tells them exactly that.

A marketing journey email to an unsubscribed address is skipped and the step's
result reads `skipped_unsubscribed` (reason `email_unsubscribed` on a drafted
send); send analytics counts it under *Unsubscribed from marketing email*, apart
from people who opted out of marketing email another way. Skips before
November 20, 2026 were counted as *Opted out of marketing email*. A campaign's
audience shows how many people unsubscribed and won't get its email. Earlier
unsubscribes were recorded as Do Not Contact and stay there, blocking every
channel.

**The unsubscribe page speaks the email's language.** It follows the language
the email declares (the language set in the template editor, or the
`<html lang>` of an HTML template), not your organization's default.

**Every template email you send has the unsubscribe button,**
transactional journeys included. Only the billing notices Boom sends you about
your own account go without it.

**Unsubscribe links don't expire.** A link in an email from months ago still
works, both the page and the one-click button in Gmail or Yahoo. Unsubscribing
twice changes nothing.

**Your customer data shows it.** When someone unsubscribes, Boom also updates
the person in your customer data: `acceptsEmailMarketing` becomes `false` and
`emailConsentWithdrawnAt` records when, and an `email_unsubscribed` event is
added to their timeline (with `via`: `one_click` or `mailto`). Segments,
exports and tools that read your customer data see them as unsubscribed. This
can take a minute. If your store later reports the person as subscribed again,
the customer data follows the store (even if they unsubscribe again), but Boom
keeps not sending them marketing email.

## What Gmail, Yahoo and Microsoft require

Gmail and Yahoo (since February 2024) and Microsoft Outlook (since May 2025)
require more from anyone sending them more than about 5,000 emails a day.
Mail that doesn't meet the rules is sent to spam or rejected.

| Requirement | Who takes care of it |
| - | - |
| **SPF and DKIM** on your sending domain | Boom, once you add the DNS records in **Settings › Email** ([setup for IT](https://docs.useboom.ai/email-for-it.md)). |
| **DMARC** record on your domain (`p=none` is enough to start) | You: it's one of the records in [Email setup for your IT team](https://docs.useboom.ai/email-for-it.md). Keep an existing DMARC record rather than replacing it. |
| **One-click unsubscribe**, honored within two days | Boom adds it to every template email and stops marketing email to a person as soon as they use it. |
| **Spam reports below 0.3%** of delivered emails (aim for under 0.1%) | You: it depends on who you send to and what you send. |

Our email providers hold us to stricter limits, across all customers. The
strictest are bounces under 4% and spam reports under 0.08%. The undeliverable list exists
to keep you well below them.

## Sending from a new domain

Inboxes don't trust a domain they've never seen. If your domain is new to
sending, or new to sending at volume, build up gradually:

* Start with your most engaged contacts: people who recently bought, signed up
  or wrote to you.
* Start with a few hundred emails a day and roughly double every few days
  while bounces and spam reports stay low.
* Avoid a sudden jump, such as a first campaign to your whole list.

## Why emails land in spam

"Delivered" only means the server accepted the email; the inbox decides where
it goes. The usual reasons, most common first:

* **People who didn't ask for it.** Purchased, old or scraped lists bring
  bounces and spam reports. Send only to people who opted in, and clean
  contacts who haven't engaged in months.
* **No DMARC record**, or one that fails. Check your domain's records in
  **Settings › Email**.
* **A sudden spike** in volume from a domain that usually sends little.
* **Content**: an email that's one big image, link shorteners, or links to
  domains with a bad reputation.
* **Low engagement**: inboxes notice when people never open your emails.

Open rates aren't a reliable signal on their own: Apple Mail opens every email
automatically, and some security filters click links. See
[open and click tracking](https://docs.useboom.ai/email-tracking.md).

## Related

> [card] [Email setup for your IT team](https://docs.useboom.ai/email-for-it.md)
>
> The DNS records, including DMARC.

> [card] [Email troubleshooting](https://docs.useboom.ai/email-troubleshooting.md)
>
> Fixes for common email problems.

> [card] [Message logs](https://docs.useboom.ai/message-logs.md)
>
> Every email and what happened to it.

> [card] [Open and click tracking](https://docs.useboom.ai/email-tracking.md)
>
> Measure opens and clicks.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.