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

# Address Importer

> Bulk-create mailboxes or forwarders from a CSV or Excel spreadsheet.

Address Importer takes a spreadsheet and turns it into mailboxes or forwarders in one go. Useful when you're migrating from another host with dozens of accounts, or onboarding a team without setting them up one click at a time.

Open it from cPanel home → **Email** → **Address Importer**.

<Frame caption="Address Importer file upload form">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/cpanel/email-management/address-importer/upload-light.png" alt="Address Importer page with type toggle and file upload" className="block dark:hidden" />

  <img src="https://mintlify.s3.us-west-1.amazonaws.com/noxity/images/cpanel/email-management/address-importer/upload-dark.png" alt="Address Importer page with type toggle and file upload" className="hidden dark:block" />
</Frame>

## Prepare your file

cPanel accepts `.csv` and `.xls` files. The spreadsheet has different required columns depending on what you're creating.

### For email accounts

| Column   | Required | Notes                                         |
| -------- | -------- | --------------------------------------------- |
| Email    | Yes      | Full address: `info@yourdomain.com`           |
| Password | Yes      | Plain text. cPanel will hash it on import     |
| Quota    | No       | In MB. Leave blank for unlimited (if allowed) |

### For forwarders

| Column      | Required | Notes                                         |
| ----------- | -------- | --------------------------------------------- |
| Source      | Yes      | Address on your domain: `info@yourdomain.com` |
| Destination | Yes      | Where to forward. Can be on any domain        |

A header row is optional but supported.

## Import

<Steps>
  <Step title="Pick what you're importing">
    Toggle between **Email Accounts** and **Forwarders** at the top.
  </Step>

  <Step title="Upload the file">
    Click **Choose File**, pick your CSV or XLS, and pick the file format if cPanel doesn't auto-detect.
  </Step>

  <Step title="Map columns">
    Match each column in your file to the corresponding cPanel field. Skip columns you don't need.
  </Step>

  <Step title="Review and import">
    cPanel previews what it's about to create. Click **Import** to commit. Errors (existing addresses, bad format) are flagged in the result page.
  </Step>
</Steps>

## Tips

* **Test with a small file first.** Import 2-3 rows, verify they look right, then run the full file.
* **UTF-8 for international names.** Save your CSV as UTF-8 to avoid mangled characters in display names.
* **Existing addresses are skipped.** If a mailbox or forwarder already exists, the import logs it and moves on. No silent overwrites.

## Need a hand?

<CardGroup cols={2}>
  <Card title="Open a ticket" icon="life-ring" href="https://members.noxity.io/submitticket.php">
    Best for anything that needs an account check or a config change on our end.
  </Card>

  <Card title="Live chat" icon="messages" href="https://noxity.io/contact">
    Faster for quick questions during business hours.
  </Card>
</CardGroup>