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

# Focus Mode

> Your mailboxes sorted into to-dos, catch-up topics and clean-up lists, with a one-card-at-a-time run to clear them.

## Overview

Focus Mode reads your inbox and sorts it into what needs you and what doesn't: emails that ask
you to do something, updates you only need to skim, and senders worth unsubscribing from. It
works across every mailbox you've connected, and every action you take there (Done, Trash,
Spam, Unsubscribe) is a normal action on that email in its own mailbox, with Undo.

There's no setting to switch it on. Once a mailbox is connected, Focus fills in by itself.

## How it works

Open **Mail** and pick the **Focus** tab, first in the row of mailboxes. You can also use
**Focus Mode** in the Mail sidebar, above Inbox, or **Open Focus Mode** on the banner at the top
of your inbox. The tab shows how many to-dos and replies are waiting.

With more than one mailbox, the menu at the top left chooses which ones you see: **All
mailboxes**, one mailbox, or several. Each row still names the mailbox it came from, and an
action always goes to that mailbox.

The page is split into sections, in this order:

| Section | What's in it |
| - | - |
| **Suggested to-dos** | Emails that ask something of you, or are waiting on your reply. Each shows the ask, the sender and a due date when there is one. |
| One section per topic | Catch-up summaries grouped by topic (for example "Purchases"): a line per update, with the senders it came from. |
| **Looks like junk** | Senders Gmail filed as promotions or social, who you've never written to and who aren't in your CRM. |
| **Promos and notifications** | Other bulk senders, grouped by sender. |
| **Everything else** | The rest of your inbox: mail not sorted yet, and anything you hid from to-dos. |

A due date shows as **Overdue** or **Due today** in colour, then **Due tomorrow** or a date.
When the same sender asks the same thing in several emails, it shows as one row with an
"N emails" pill, and Done or Trash acts on all of them.

> [!NOTE]
>
> Focus reads your recent mail first. On a new mailbox you'll see "Reading your recent mail. Focus Mode fills in over
> the next few minutes.", and **Sorting…** in the header while older mail is still being read.

## Using it

### Work a row

Hover a row for its buttons: **Done** (archive), **Reply** on a reply, **Move to Trash**, and
**⋯**. Suggested actions (**Add to calendar**, **Add** or **Link** a record) join them when the
email has one. The **⋯** menu has **Create rule for this sender**, **Not a to-do** (hides it from to-dos),
**Helpful** and **Not helpful**.

Clicking a row opens the email in a pane beside the list, so you never leave Focus. In the pane,
**e** marks it done, **#** trashes it, **j** / **k** move to the next and previous email,
**⇧R** or **↵** replies, and **Esc** closes it.

Every move shows a toast with **Undo** for 8 seconds. **z** undoes the latest one.

### Clear a whole section

Each section header has its own sweep: **Done all N** on a topic, **Spam all N** on Looks like
junk, **Archive all N** on Promos and notifications, and **Done all N** on Everything else. A
sender row in a clean-up list has **Unsubscribe** and **Spam N** or **Archive N**, and its name
expands to show its emails.

To pick rows yourself, tick their checkboxes (Shift-click selects a range, **⌘A** selects
everything), then use **Done**, **Trash** or **Spam** in the bar that appears.

### Go through it one card at a time

**1. Start the run**

Press **Go through all N** in the header, or **One by one** on a section header to start there.

**2. To-dos**

Each card shows the sender, when it arrived, the email's opening lines and a **Suggested** next step. Choose
**Done** (E), **Reply** (R), **Later** (H), **Spam** (!) or **Skip →** (J). **↵** runs the suggested move.

**3. Catch-up topics**

A card lists every line in the topic, ticked. Untick what you want to keep in your inbox, then **Done N** (↵) or
**Trash N** (#).

**4. Clean-up senders**

Choose **Spam N** (S), **Archive N** (A), **Unsubscribe** (U) or **Keep →** (K). Junk senders show Spam first.

**5. Finish**

The last card tallies what you did ("3 done · 1 for later · 2 archived…"). Press **Back to Focus**, or **Esc** at
any point to leave.

### Clear old mail

When your inbox holds 50 or more emails older than a week, the bar at the bottom offers **Clear
old mail**. It moves older mail to Archive. Nothing is deleted, and you can undo it for 7 days.

* **Keep mail from the last**: Day, Week (the default), 2 weeks, Month or 3 months.
* **Always keep**: to-dos and replies Focus found, mail from people you've written to or who are
  in your CRM, starred mail, and (off by default) unread mail.

The dialog shows how many emails it will archive and keep. **Review ›** lists both, by sender:
untick a kept email to archive it anyway, or tick a sender to keep all of their mail. Press
**Archive N** to start. The bar shows "Finding old mail", then "Archiving old mail · N of N",
and ends with **Undo** and **Open Archive**. Clear old mail is on the web only.

### Rules from Focus

When your [email rules](https://docs.custral.com/comms/email/rules.md) handled mail today, a strip at the top reads
"Rules handled N emails today". **Review N →** opens **Handled by rules**, where you can see what
each rule did today, in the last 7 days or 30 days, and **Undo** it one email at a time or with
**Undo all N**. **Manage rules** opens Settings. Focus may also suggest a rule from your filing
habits, with **Create rule**, **Edit first** and **Not now**.

## Troubleshooting

| Symptom | Likely cause | What to check |
| - | - | - |
| No **Focus** tab in Mail | No mailbox is connected yet, or Focus hasn't answered for one yet | Connect a mailbox ([Get started](https://docs.custral.com/comms/email/getting-started.md)), then give it a few minutes. |
| "Connect a mailbox to see what it needs from you here." | No mailbox is connected | Connect one under **Settings → Account → Connected Accounts**. |
| The mailbox menu is missing | You have only one mailbox | The menu only shows with two or more. |
| An email that needs you isn't a to-do | It's still being sorted, or it was hidden | Look under **Everything else**: "not sorted yet" or "you hid this from to-dos". Mark **Not helpful** on a wrong row. |
| **Go through N sorted** instead of **Go through all N** | Everything else still has mail | The run covers sorted sections only. Clear Everything else with its own **Done all N**. |
| No **Clear old mail** button | Fewer than 50 inbox emails are older than a week | Nothing to do. It appears once that many old emails pile up. |
| "Couldn't clear old mail" | The sweep couldn't start, for example one is already running | The toast adds "It's still in your inbox." Wait for the running sweep, then try again. |
| "This email couldn't be opened here." | The email was moved or deleted since Focus last read | Use **Try the full email**, or **Refresh** in the header. |
| "Couldn't refresh Focus Mode" | The read failed | Try again in a moment. Your last answer stays on screen. |

> [!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] [Email rules](https://docs.custral.com/comms/email/rules.md)
>
> Sort new mail automatically as it arrives.

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

> [card] [Reminders](https://docs.custral.com/comms/email/reminders.md)
>
> Send a thread away and bring it back later.

> [card] [Email overview](https://docs.custral.com/comms/email/overview.md)
>
> Everything Mail can do.


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