> ## 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.

# Email Rules

> Label, mark read, mark done, trash or spam new mail as it arrives, and block senders you never want to hear from.

## Overview

An email rule says what to do with new mail that matches it: "label everything from amazon.com
as Receipts and mark it done". Rules run the moment an email arrives in a mailbox they watch,
before anyone is notified, so mail a rule marks done never pings you.

Rules live in **Settings → Mail → Email Rules**, which has two tabs: **Rules** and **Blocked
senders**.

![Settings → Mail → Email Rules: every rule on the mailboxes you can read.](https://docs.custral.com/images/screens/comms/email-rules-light.png)

Settings → Mail → Email Rules: every rule on the mailboxes you can read.

## How it works

* **A rule belongs to its mailboxes, not to the person who made it.** Everyone who can read one
  of its mailboxes sees it, with "Made by …" under its name. Changing, deleting or applying it
  needs edit access on every mailbox it watches. It keeps running if its maker leaves.
* **It runs on new mail only.** Saving a rule changes nothing already in your inbox, unless you
  press **Save and apply to past emails**.
* **When several rules match, their actions combine**: labels first, then read, then one move.
  Spam beats trash, and trash beats done.
* **Every action can be undone.** The email's side panel shows "(rule name) handled this email ·
  Undo", and [Focus Mode](https://docs.custral.com/comms/email/focus.md) lists everything rules did under **Handled by
  rules**.

### What a rule can match

| Field | Operators | Example value |
| - | - | - |
| **Sender address** | is, contains | `receipts@amazon.com` |
| **Sender domain** | is, contains | `amazon.com` |
| **Sent to** | is, contains | `billing@yourcompany.com` |
| **Subject** | is, contains | `Your order` |
| **Body** | is, contains | `unsubscribe` |

With two or more conditions, choose **All match** or **Any matches**. **Add exception** adds an
"Except if any of these match" list: an email that matches any exception is left alone. A rule
takes up to 10 conditions and 10 exceptions.

### What a rule can do

| Action | Notes |
| - | - |
| **Add a label** | Only when the rule watches exactly one mailbox. Each mailbox has its own labels. |
| **Mark as read** | |
| **Mark done (archive it)** | On by default. Turned off when trash or spam is on. |
| **Move to trash** | Your mail provider's Trash, not a permanent delete. Needs Delete on the mailbox. |
| **Move to spam** | Trains your provider's spam filter against the sender. |

## Using it

**1. Start a rule**

Press **New rule** in Settings → Mail → Email Rules. You can also start one from an email: the bolt button in the
email toolbar ("Create a rule for mail from this sender"), **Create a rule for mail from …** in a mail row's
**Unsubscribe or block** menu, or **Make a rule** on a Focus topic.

**2. Pick the mailboxes**

Choose one or more under **Mailboxes**. Only mailboxes you can edit are listed.

**3. Set the conditions**

Under **When an email arrives where**, add conditions and, if you need them, exceptions. A rule started from an email
matches the sender's domain, or the exact address on a shared provider such as gmail.com.

**4. Choose what happens**

Tick the actions under **Then**. The editor counts matching emails as you go: "Matches 12 emails from the last 30
days."

**5. Save**

**Save** runs the rule on new mail from now on. **Save and apply to past emails** also runs it on matching inbox
emails from the last 30 days, up to 200, and says how many it is applying to.

> [!TIP]
>
> For a one-click rule, open an email and use the **Rules** card in its side panel: "Next time mail from … arrives:"
> **Always mark done**, **Always mark read** or **Always label…**.

Turn a rule off with its **On** switch, or remove it with **Delete rule**. Deleting a rule
leaves the emails it already handled as they are.

## Blocked senders

Blocking sends a sender's **future** email on one mailbox straight to Trash. It never reaches
your inbox and never shows as unread. It's stronger than unsubscribing: unsubscribe asks the
sender to stop, a block means you stop seeing them.

* **Block a sender** from an open email with the block button in the toolbar, or from a mail
  row's **Unsubscribe or block** menu: **Block sender: …** or **Block domain: …**. The email you
  blocked from moves to Trash, and the toast offers **Undo**.
* **Block domain** blocks anyone at that domain. It isn't offered for shared providers such as
  gmail.com, outlook.com or yahoo.com, where it would block strangers.
* **A block covers one mailbox.** The same sender on two mailboxes needs a block on each.
* **Older mail stays put.** Only mail that arrives after the block goes to Trash.
* **Review and undo** blocks on the **Blocked senders** tab: each row shows the sender (or
  "Anyone @domain"), the **Account** it covers and when it was blocked. **Unblock** lets their
  future mail into the inbox again. Anything already in Trash can be restored from your mail
  provider's Trash.

Blocks are made from an email. There's no form to type an address in.

## On mobile

In the mobile app, open an email, tap **⋯**, then **Rules for this sender** for the presets
**Always mark done**, **Always mark read**, **Always move to Trash** and **Always label…**, and a
switch for each rule that already covers the sender. Rules with more conditions, and editing
them, are on the web.

## Troubleshooting

| Symptom | Likely cause | What to check |
| - | - | - |
| "A label belongs to one mailbox. Pick just one." | The rule watches several mailboxes and has a label action | Pick one mailbox, or make one rule per mailbox. |
| "Pick at least one mailbox." / "Add at least one condition." / "Pick at least one thing to do." | The rule is incomplete | Fill in the part named before saving. |
| The switch and **Delete rule** are greyed out | You don't have edit access on every mailbox the rule watches | The tooltip says so: "Changing this rule needs edit access on every mailbox it watches." |
| Saving a trash rule says "You can't set this rule on that mailbox" | You can edit the mailbox but don't have full access to it | Ask an admin for full access on that mailbox, or use **Mark done** instead of **Move to trash**. |
| A rule didn't touch mail already in the inbox | Rules run on new mail only | Edit it and press **Save and apply to past emails** (inbox, last 30 days, up to 200). |
| "No emails from the last 30 days match yet." | Nothing in the inbox matches the conditions | Loosen a condition (for example **contains** instead of **is**), or check the exceptions. |
| No **Block domain** option | The sender uses a shared provider like gmail.com | Block the sender's address instead. |
| A blocked sender's email still reached the inbox | The block is on a different mailbox, or the email came first | Check the **Account** column on the Blocked senders tab. |
| "Couldn't block" | The block failed | The toast adds "Nothing was moved to Trash." Try again. |

> [!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] [Focus Mode](https://docs.custral.com/comms/email/focus.md)
>
> See what rules handled today, and undo it.

> [card] [Reading & replying](https://docs.custral.com/comms/email/threads.md)
>
> The row menu, unsubscribe and Mail shortcuts.

> [card] [Mailbox settings](https://docs.custral.com/comms/email/mailbox-settings.md)
>
> Signatures, forwarding, auto-replies and more.

> [card] [Suppressions](https://docs.custral.com/comms/suppressions/overview.md)
>
> Bounces and unsubscribes on what you send.


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