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

# Campaigns

> Email everyone on a list at once. Each person gets their own personalized copy, tracked per person, with an unsubscribe link added for you.

## Overview

A campaign sends one email to everyone on a list, a smart list, a cohort or a selection of
table rows. It's a mail merge: each person gets their own copy, sent from one of your connected
inboxes, personalized with their own fields. Because every copy is separate, the report can say
who opened, clicked, replied, bounced or unsubscribed.

![Campaigns: every campaign with its status, audience and opens.](https://docs.custral.com/images/screens/comms/campaigns-light.png)

Campaigns: every campaign with its status, audience and opens.

## How it works

* **Where it lives.** Open **Campaigns** from the **More** tile in the sidebar, or add it to your
  sidebar with **Customize modules…**. You can also start one from a list with **Email list**,
  from a list's **Campaigns** tab, or by selecting rows in a table with an email property and
  choosing **Send email**.
* **A draft saves itself.** There's no Save button. The status beside the title reads
  **Saved**, **Saving…** or **Not saved** with **Retry**, and **⌘S** saves at once.
* **Everyone is checked before sending, and again in every batch.** People with no email
  address, a duplicate address, a missing personalization field, or who unsubscribed or are on
  your suppression list are skipped, with the reason shown. A large campaign takes a while to
  send, so someone who unsubscribes halfway through is still skipped.
* **Nobody is sent it twice.** If a send is interrupted, that person is marked failed rather
  than sent again.
* **Replies come back to your inbox** like any other email. A campaign doesn't open a
  conversation per recipient.

## Using it

**1. Create the campaign**

In **Campaigns**, press **New campaign**. Give it a **Name** (only your team sees it).

**2. Choose who gets it**

Under **To**, pick a list from **Lists**, **Smart lists** or **Cohorts**, or **New list**. The panel beside it
says "N people will receive it" and lists anyone skipped, and why.

**3. Choose the sender**

Under **From**, pick one of your connected inboxes. Under **Send as**, keep **Individual emails** (one copy per
person, personalized and tracked) or choose **One email, BCC** (see below).

**4. Write it**

Add a **Subject** and the body. **Personalize** inserts fields **From each recipient** (First name, Last name,
Full name, Company, Email address), **From you** (My first name, My full name) or any field of the list's object.
**Snippets** (or typing `;`) inserts a saved snippet, and its fields stay personal to each recipient. When some
people lack a field, the panel asks for a fallback ("They'll see: there"), or they're skipped.

**5. Check the footer**

**Add an unsubscribe link and mailing address** is on by default, and marketing email must include both. Turn it off
only for personal updates, like an investor letter.

**6. Preview and test**

The preview shows the email as a recipient gets it. **Preview as** steps through up to 25 recipients. **Send
test** sends the personalized email to you, untracked, with "\[Test]" in the subject.

**7. Send or schedule**

Press **Send to N** and confirm **Send now**. Or open the arrow beside it, choose **Schedule…**, and pick a time
under **Send at** (in your timezone). A scheduled campaign goes to whoever is on the list at that time.

### After it sends

The campaign opens as a report with **Overview** and **Email** tabs.

| Tile | Counts |
| - | - |
| **Sent** | Emails sent, with how many are still to go, skipped or failed |
| **Delivered** | Sent and not bounced. Email has no delivery receipt. |
| **Opened** | People who opened it. Proxy and scanner fetches don't count. |
| **Clicked** | People who clicked a link |
| **Replied** | People who replied |
| **Bounced** | Addresses that bounced. A hard bounce is added to your do-not-email list. |
| **Unsubscribed** | People who used the unsubscribe link |

Rates are a share of delivered. The recipients table below filters by **Opened**, **Clicked**,
**Replied**, **Bounced**, **Unsubscribed**, **Failed** and **Skipped**, and clicking a person
opens their thread.

While a campaign sends, **Stop sending** stops it: nobody else gets it, and emails already sent
stay sent. A scheduled campaign has **Unschedule**, which turns it back into a draft you can
edit and schedule again.

### One email, BCC

**One email, BCC** sends one email to your own inbox with up to 50 recipients BCC'd per email.
Everyone gets the same body, so it gives up three things: recipient personalization fields
(only **From you** fields work), the unsubscribe footer, and tracking. The report shows "Not
tracked with BCC". Suppressed people are still skipped.

## Limits

* Up to 10,000 recipients per campaign.
* During a trial, up to 100 recipients per campaign and 300 sends a day. The rest wait for the
  next day.
* If the inbox hits its provider's sending limit, Custral waits and retries for up to a day.
  The status keeps reading "Sending N of N" while it waits.
* Campaigns are on the web only. There's no API, SDK or Stella tool for them.

## Access

A campaign inherits sharing from the list it sends to: sharing a list shares its campaigns.
You can also share a campaign with people from its **Share** button. Viewing needs read access;
changing, testing, sending or stopping needs edit access; deleting a draft needs delete access.
Sending also needs edit access on the sending inbox and read access on the list.

## Troubleshooting

| Symptom | Likely cause | What to check |
| - | - | - |
| **Send** is disabled | Something required is missing | Its tooltip names it: "Choose the inbox to send from.", "Choose who to send to.", "Add a subject.", "Write the email." or "Add your mailing address." |
| "Connect an email inbox first" under From | You have no connected inbox | Connect one ([Get started with Email](https://docs.custral.com/comms/email/getting-started.md)). |
| "Remove placeholders that can't be personalized." | The body has a fill-in blank or a field Personalize can't fill | Replace it with a field from **Personalize**, or plain text. |
| "Remove the recipient's personalization fields. A BCC email is the same for everyone." | BCC mode with recipient fields | Switch to **Individual emails**, or remove the fields. |
| "N skipped · Missing a personalization field" | Some people lack a field you used | Add a fallback in the audience panel. |
| "This audience has N records. A campaign can go to at most 10,000." | The list is too big | Split it into smaller lists. |
| "Only a draft can be edited. Unschedule it first." | The campaign is scheduled | Press **Unschedule**, edit, then schedule again. |
| The campaign shows **Failed** with "Stopped: …" | The inbox stopped accepting mail, or was disconnected | "The inbox this campaign sends from is no longer connected." means reconnect it and send a new campaign to the rest. |
| "This email looks like it could be phishing or a scam, so it wasn't sent." | The trial content check refused it | Write to [support@custral.com](mailto:support@custral.com) if that's wrong. |
| **New campaign** is disabled | You don't have edit access to the workspace | "Only members with edit access can send campaigns." |

> [!NOTE]
>
> When reporting an issue, include the request id shown in the error toast. It links the in-app error to the server
> logs.

## Related

> [card] [Lists](https://docs.custral.com/data/collections/list.md)
>
> Build the list a campaign sends to.

> [card] [Suppressions](https://docs.custral.com/comms/suppressions/overview.md)
>
> Unsubscribes and bounces every send honours.

> [card] [Deliverability](https://docs.custral.com/comms/deliverability/overview.md)
>
> Authenticate your domain before sending volume.

> [card] [Email snippets](https://docs.custral.com/comms/email/templates.md)
>
> Reusable text you can drop into a campaign.


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