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

# Create and manage mailboxes

> Add mailboxes on a mail domain, give them aliases, reset a password nobody saved, and suspend or delete a mailbox.

export const Loop = ({id, src, alt, caption}) => {
  if (!src) {
    return <Placeholder id={id} kind="loop" label="Animation coming soon" description={alt} icon={<PlayIcon />} />;
  }
  return <figure className="brd-media" data-media-id={id}>
      <video className="brd-media-frame" src={src} autoPlay muted loop playsInline aria-label={alt} />
      {caption && <figcaption className="brd-media-caption">{caption}</figcaption>}
    </figure>;
};

export const Screenshot = ({id, src, srcDark, alt, caption}) => {
  if (!src) {
    return <Placeholder id={id} kind="screenshot" label="Screenshot coming soon" description={alt} icon={<ImageIcon />} />;
  }
  return <figure className="brd-media" data-media-id={id}>
      <img className="brd-media-frame block dark:hidden" src={src} alt={alt} />
      <img className="brd-media-frame hidden dark:block" src={srcDark || src} alt={alt} />
      {caption && <figcaption className="brd-media-caption">{caption}</figcaption>}
    </figure>;
};

Create the addresses people actually use, and look after them afterwards. At the end, a mailbox
shows **Active** and its owner can sign in from any mail client.

<Screenshot id="ss-mailbox-manage-mailboxes-hero-list" alt="A mail domain's Mailboxes tab listing addresses with Active badges, their storage used against quota, and the Add Mailbox button" />

<Info>
  **Before you start:** add the domain under **Mailboxes** first. See
  [Add a mail domain](/mailbox/add-a-mail-domain). You don't have to wait for its DNS to verify:
  mailboxes can sign in and send straight away, and they start receiving mail once the MX record is
  in place.
</Info>

## Create a mailbox

<Steps>
  <Step title="Open the Add Mailbox panel">
    Open the domain from **Mailboxes**, then on its **Mailboxes** tab select **Add Mailbox**.
  </Step>

  <Step title="Enter the address">
    Enter the part before the `@`, an optional display name, and a storage quota of 1, 5, 10, 25, 50
    or 100 GB. The default is 5 GB. Addresses use letters, numbers and single `.`, `_` or `-`
    separators, and are stored in lowercase.

    <Screenshot id="ss-mailbox-manage-mailboxes-01-add" alt="The Add Mailbox panel with the local part, display name and a storage quota of 5 GB selected" />
  </Step>

  <Step title="Copy the password">
    Brudcast generates a 32-character password and shows it once. Copy it before you select
    **Done**, and send it to the person with the
    [mail client settings](/mailbox/connect-a-mail-client). If it's lost, reset it.
  </Step>
</Steps>

The mailbox shows **Provisioning** while it's created, then **Active**. Addresses that are reserved,
and the limits on how many mailboxes and aliases your plan allows, are in
[Hosted mailboxes](/mailbox/overview#plans-and-limits).

## Aliases

An alias is another address that delivers into an existing mailbox, so `sales@example.com` can land
in Jane's inbox without a second mailbox or password. On the mailbox's row, select **⋮ > Manage
Aliases**, enter the part before the `@` and select **+**. An alias is always on the same domain as
its mailbox.

<Loop id="lp-mailbox-manage-mailboxes-alias" alt="Adding an alias in the Manage Aliases dialog and the new address appearing in the mailbox's alias list" />

Removing an alias stops mail reaching the mailbox and the address stays reserved. Deleting a mailbox
removes its aliases too.

## Reset a password

Brudcast can't show a mailbox password again, so a lost password has to be replaced. In the
mailbox's actions menu (**⋮**), select **Reset Password** and confirm. The new password is shown
once.

The mailbox shows **Provisioning** while the change applies, then **Active**. The old password stops
working, so update every mail client that uses it.

## Suspend or delete a mailbox

**Suspend** stops a mailbox signing in, sending and receiving, and keeps its stored mail.
**Reactivate** in the same menu undoes it.

<Warning>
  **Delete** removes the mailbox, its aliases and all its stored messages, and can't be undone. The
  addresses stay reserved, so you can't create them again. If you might need the mailbox later,
  suspend it instead.
</Warning>

A deleted address stays reserved so that mail still on its way to the old owner can't reach someone
new. A mail domain can only be removed once every mailbox on it has been deleted.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The mailbox stays on Provisioning, or shows Failed" icon="circle-alert">
    **Why:** the mailbox is still being created or a new password is still being applied.
    **Failed** (`provisioning_failed`) means it couldn't be created.

    **Fix:** wait a moment and reload the **Mailboxes** tab. If it stays **Failed**, delete it and
    add it again, or write to [support@brudcast.com](mailto:support@brudcast.com).
  </Accordion>

  <Accordion title="The address can't be created" icon="circle-alert">
    **Why:** the part before the `@` is longer than 64 characters, uses characters other than
    letters, numbers and single `.`, `_` or `-` separators, or is one of the reserved names such as
    `postmaster` or `abuse`. A deleted address stays reserved too.

    **Fix:** choose another address. The full list of reserved names is in
    [Hosted mailboxes](/mailbox/overview#plans-and-limits).
  </Accordion>

  <Accordion title="“Plan limit reached” when you add a mailbox" icon="circle-alert">
    **Why:** your Mailbox plan's mailbox allowance is used up, or you've reached the 25 mailboxes an
    organization can have across every domain.

    **Fix:** delete a mailbox you no longer use, or move to a larger plan. See
    [Plans and subscriptions](/billing/plans-and-subscriptions).
  </Accordion>
</AccordionGroup>

## Related

<Columns cols={2}>
  <Card title="Connect a mail client" icon="mail" href="/mailbox/connect-a-mail-client">
    Server settings and steps for popular apps.
  </Card>

  <Card title="Add a mail domain" icon="globe" href="/mailbox/add-a-mail-domain">
    Register your domain and publish its records.
  </Card>

  <Card title="Hosted mailboxes" icon="inbox" href="/mailbox/overview">
    Statuses, plan limits and how mail reaches a mailbox.
  </Card>
</Columns>