> For the complete documentation index, see [llms.txt](https://support.docstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.docstudio.com/admin-panel/managing-mailboxes-admin/mailbox-settings-overview.md).

# Mailbox Settings Overview

This document explains how to manage mailbox identity settings, including UUID, name, aliases, visibility, and envelope forwarding.

{% hint style="info" %}
See the [Glossary](https://support.docstudio.com/glossary/glossary) for DocStudio term definitions.
{% endhint %}

### Mailbox UUID

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FMeYhaKK2h3Lm7cPw57WQ%2Fimage.png?alt=media&amp;token=ad11372e-e082-4c2c-be50-b3577069dac6" alt=""><figcaption></figcaption></figure>

Click the **Copy** <img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2F4dFAYofoLyjZzwLgdfpU%2Fimage.png?alt=media&amp;token=f803ddf7-3013-44a4-aa51-e3ff30febc6a" alt="" data-size="line"> icon next to the mailbox UUID. After copying, you’ll see a notification in the top-right corner.

### Edit the mailbox name

{% columns %}
{% column width="58.333333333333336%" %}
The **Name** field accepts 1–255 characters.

1. Hover the mailbox name and edit it.
2. Click the <img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FSYWxTeVL8E4IfuxZzFAv%2Fimage.png?alt=media&amp;token=d0d1ef67-fa38-4797-825c-16c14b3a4fb2" alt="" data-size="line"> button.
3. After saving, you’ll see a notification in the top-right corner.
   {% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FSTySZse9rGEH9r9l8Ja5%2Fimage.png?alt=media&amp;token=57281923-5a59-4eac-a859-61b4bfdcaa64" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Hide mailbox name and aliases

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FsvCb3IjZirncrefBqNZF%2Fimage.png?alt=media&amp;token=6df1ea26-9ab9-4874-b6c1-f6338ab8aa54" alt=""><figcaption></figcaption></figure>

Enable **Hide name/aliases from other accounts** to hide the mailbox from other accounts. When enabled, the mailbox name and aliases are visible only to users with access to the account.

### Hide email from Reply-To on the platform

Enable **Hide Sender email in the "Reply-To" for envelope-related emails**. This setting allows you to show or hide the sender’s email address in the **Reply-To** field for envelope-related emails.

* If enabled — the sender’s email address will be hidden in the **Reply-To** field for envelope-related emails.
* If disabled — the sender’s email address will appear in the **Reply-To** field.

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FqMfSZ0vKxU6SMOMMzhJb%2Fimage.png?alt=media&amp;token=d7b0c319-81ee-453b-8810-6b041ccafdb6" alt=""><figcaption></figcaption></figure>

**To activate this functionality, follow the instruction below:**

1. Enable the toggle switch in this section.
2. Click the <img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2Fv6n7CTXR51zConU1a5cg%2Fimage.png?alt=media&amp;token=f1d8dc6e-9768-4387-8f98-d3d5e2e31efd" alt="" data-size="line"> button.

{% hint style="info" %}
As a result, the **Reply-To** header will not be added to envelope-related emails that are sent on behalf of users within an account where this option is enabled.
{% endhint %}

**Envelope-related emails**

{% columns %}
{% column %}

1. Envelope created
2. Envelope received
3. Envelope invitation received
4. Envelope role completed required actions
5. Envelope is about to expire
6. Envelope has unfinished role
   {% endcolumn %}

{% column %}
7\. Envelope received for approval
8\. Envelope gets a new comment
9\. Envelope added to chain/removed from chain
10\. Envelope Cancelled
11\. Envelope Expired
12\. Envelope Completed
{% endcolumn %}
{% endcolumns %}

### Manage mailbox aliases

You can add multiple aliases to a mailbox, but identical aliases cannot be assigned to the same mailbox. Different mailboxes may use the same alias. To make an alias unique across the entire system, use a qualified alias. A qualified alias includes a prefix followed by a colon (for example, `TIN:youralias`). Qualified aliases may contain only letters, numbers, and dashes.

{% hint style="info" %}
For qualified aliases, only letters, numbers, and dashes are allowed.
{% endhint %}

#### Add an alias

{% columns %}
{% column %}

1. Click the aliases area.
2. Enter the alias.
3. Press Enter, `.` , or `,` to add it to the list.
4. Click the <img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FSYWxTeVL8E4IfuxZzFAv%2Fimage.png?alt=media&amp;token=d0d1ef67-fa38-4797-825c-16c14b3a4fb2" alt="" data-size="line"> button.
   {% endcolumn %}

{% column %}

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FiOzcC45s6tE2OHmyifSC%2Fimage.png?alt=media&amp;token=50dca5aa-d0b5-4c5f-b1fd-5823ff0d91cb" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

#### Remove an alias

1. Click the remove ![](https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FMJwZL5SdhviNZdhkLQ6E%2Fimage.png?alt=media\&token=3fbd9155-21a7-41c9-a2b8-009e565643e9) icon next to the alias.
2. Click the <img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FSYWxTeVL8E4IfuxZzFAv%2Fimage.png?alt=media&amp;token=d0d1ef67-fa38-4797-825c-16c14b3a4fb2" alt="" data-size="line"> button.

After saving, you’ll see a notification in the top-right corner.

### Configure envelope forwarding

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FXVIrgfeg0L9bVuq7uUsj%2Fimage.png?alt=media&amp;token=8bd0827e-8f54-4aed-9516-75bd7cdaf2f9" alt=""><figcaption></figcaption></figure>

Use this section to forward all incoming envelopes automatically.

1. Select a delegate mailbox.
2. Set **Effective from** (optional).
3. Set **Effective until** (optional).
4. Enable **Active forwarding**.
5. Click the <img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FSYWxTeVL8E4IfuxZzFAv%2Fimage.png?alt=media&amp;token=d0d1ef67-fa38-4797-825c-16c14b3a4fb2" alt="" data-size="line"> button.

To disable forwarding, turn it off and click the <img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FSYWxTeVL8E4IfuxZzFAv%2Fimage.png?alt=media&amp;token=d0d1ef67-fa38-4797-825c-16c14b3a4fb2" alt="" data-size="line"> button.

### Create Custom Dashboard

To create a custom dashboard, follow the instructions below:

1. Open the **Mailboxes** tab.
2. Select a mailbox and click the **Settings** <img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FJF6UKc52vmS12HdaSLHe%2Fimage.png?alt=media&amp;token=9b913b50-b924-4e95-a107-33da8f09d948" alt="" data-size="line"> icon.

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FPn563UHREYKLW7TkWxq2%2Fimage.png?alt=media&amp;token=04529a42-a846-41c6-a934-c0eb0d5214fb" alt=""><figcaption></figcaption></figure>

1. Open the **Dashboard** tab.
2. Enter your HTML code, which will replace the default dashboard, into the editor.
3. Click the **Activate custom dashboard** checkbox.
4. Click the <img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FaQ9RNm0jFGgvtmXLWyVv%2Fimage.png?alt=media&amp;token=8ba04a3d-1891-470d-94ba-c8d2983e14cb" alt="" data-size="line"> button.

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FIUfQSS0kXw2Lu2ACHmTV%2Fimage.png?alt=media&amp;token=2ba7d2c6-7a7f-484c-9c35-ee60b49d6a04" alt="" width="487"><figcaption></figcaption></figure>

The dashboard will be changed to a custom version for this specific mailbox and all users who have access to the mailbox.

{% hint style="info" %}
Custom HTML cannot be larger than 16 MB.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://support.docstudio.com/admin-panel/managing-mailboxes-admin/mailbox-settings-overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
