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

# Mailbox settings

> Per-inbox settings (signature, From name, forwarding, auto-reply, warming, conversations) and your own Mailbox and Composer preferences.

## Overview

Mail has settings in three places:

| Where | What it controls | Who it affects |
| - | - | - |
| A mailbox's **Email settings** tab | Signature, From name, forwarding, auto-reply, warming, conversations | That one inbox |
| **Settings → Mail → Mailbox and Composer** | Inbox count, Archive after reply, Smart compose | You only |
| **Settings → Inbox → Stages & Rules → What becomes one** | Which mail becomes a customer conversation | Every inbox, unless one overrides it |

To open a mailbox's settings, press the gear (**Channel Settings**) in Mail's header, or open
the mailbox under **Settings → Channels**, then the **Email settings** tab.

## Per-inbox settings

| Setting | What it does | Default |
| - | - | - |
| **Enable Smart Forwarding** | Forwards incoming email to the address in **Forward To**. | Off |
| **From Name** | The sender name people see when you reply from this inbox. | |
| **Auto-promote to Conversation** | Overrides the workspace's new-mail rule for this inbox only (see below). | Workspace default |
| **Email Signature** | Added to every new message and reply from this inbox. | Empty |
| **Include 'Sent via Custral' footer** | Adds a short Custral footer to what you send. | |
| **Enable Email Warming** | Builds the inbox's sender reputation by raising its daily volume gradually: **Target Daily Limit**, **Current Daily Limit** and **Ramp Rate (emails/day increase)**. | Off |

### Auto-reply

Turn on **Send an auto-reply** to answer mail that arrives in this inbox.

* **Start from a template**: *We got your email*, *After hours*, *Out of office* or *Company
  holiday*. A template fills the schedule and the message; nothing is saved until you press
  **Save changes**.
* **Send it**: **Always**, **Outside working hours** (your workspace hours, or **Custom hours
  for this inbox**) or **Between dates** (one or more From / Until ranges, each with an optional
  label).
* **Reply to**: **New conversations only** or **Every inbound email**.
* **Same sender at most once every**: 1, 4, 7 or 30 days, so nobody gets your auto-reply twice
  in a row.
* **Subject**: leave it empty to reply with "Re:" and the sender's own subject.
* **Message**: `{{first_name}}` becomes the sender's first name, or "there" when their email
  carries no name Custral trusts. `{{subject}}` is their subject. Your signature is added below.

## Which mail becomes a conversation

Every email arrives in Mail either way. This setting decides whether a thread **also** becomes
a customer conversation in **Inbox**, with a record, an assignee and email workflows.

| Option | What happens |
| - | - |
| **Every inbound email** | Nothing is missed. Newsletters and receipts land in your conversations list too. |
| **Email from people in your CRM** | Only mail whose sender matches a contact in your CRM. |
| **Only when I say so** (the default) | You promote a thread yourself with **⇧C** (**Create Conversation** in the email toolbar). Email workflows never run. |

Set the workspace default in **Settings → Inbox → Stages & Rules**, on the **What becomes one**
tab's **Email** card, where
you can also narrow **Which objects count as customers** and keep senders out with **Leave
out**. A single inbox can override it with **Auto-promote to Conversation**.

> [!WARNING]
>
> With **Only when I say so**, a thread that never becomes a conversation never fires the "Email received" trigger,
> so workflows that start from an email stay idle. The setting warns you: "Email workflows won't run".

## Mailbox and Composer

These follow your account, wherever you use Custral.

![Settings → Mail → Mailbox and Composer.](https://docs.custral.com/images/screens/comms/smart-compose-light.png)

Settings → Mail → Mailbox and Composer.

| Setting | Options | Default |
| - | - | - |
| **Inbox count** | **Emails in inbox** (counts everything, so it drops as you archive) or **Unread only** | Emails in inbox |
| **Archive after reply** | Sending a reply marks the thread done and archives it, in your mail provider too | Off |
| **Smart compose** | AI suggests how to finish your sentence. See [Smart Compose](https://docs.custral.com/comms/email/smart-compose.md). | On |

## Troubleshooting

| Symptom | Likely cause | What to check |
| - | - | - |
| Emails arrive in Mail but never show up in Inbox | The new-mail rule is **Only when I say so** (the default) | Promote the thread with **⇧C**, or change it under Stages & Rules → **What becomes one**. |
| One inbox ignores the workspace's new-mail rule | It has its own **Auto-promote to Conversation** setting | The Email card says how many inboxes have their own setting. Set that inbox to **Workspace default**. |
| Email workflows never run | Threads aren't becoming conversations | See the warning above. |
| The same person got the auto-reply only once | **Same sender at most once every** is doing its job | Shorten the interval if you need more. |
| The auto-reply says "Hi there" | The sender's email carried no name Custral trusts | Expected. `{{first_name}}` falls back to "there". |
| Threads vanish from the inbox after you reply | **Archive after reply** is on | Turn it off under Mailbox and Composer. |

> [!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

* [How threading works](https://docs.custral.com/comms/email/threading.md): what a conversation is, and how replies join one.
* [Email rules](https://docs.custral.com/comms/email/rules.md): sort new mail automatically.
* [Deliverability](https://docs.custral.com/comms/deliverability/overview.md): domains, authentication and warming.
* [Smart Compose](https://docs.custral.com/comms/email/smart-compose.md)


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