---
title: "Bulk importing addresses"
date: "2015-04-03"
category: "email"
slug: "bulk-importing-addresses"
---

## Overview

When migrating between hosting providers, you can add multiple e-mail addresses at once through the [[logging-into-the-control-panel]].

## Steps

1. Go to **Mail** > **Manage Mailboxes**
2. Click **Add Multiple Addresses** (the bulk address form will expand)
3. Enter each address on its own line using the format: `<email> <forward1>, <forward2>, ...`
4. Click **Bulk Add Addresses**

## Syntax Rules

### Domain Extrapolation

The first value on each line is the e-mail address to create. If no domain is specified, the domain used to log into the control panel is assumed.

Example: `myadmin matt@apnscp.com, joe@example.com`

If logged in with domain `example.com`, the address created is `myadmin@example.com`.

### Wildcards

Use an asterisk (`*`) to create an address on every [[authorizing-hostnames-handle-e-mail]].

Example input: `help@* myuser`

If two domains exist (`example.com` and `apnscp.com` as an [[creating-addon-domain]]), this expands to:

- help@example.com -> myuser@example.com
- help@apnscp.com -> myuser@apnscp.com

### Local Users

Any destination without a domain qualifier (e.g., no _@example.com_) is treated as a local user delivery. The login domain is appended automatically, following the same rules as creating a forward with **Local Users** selected in **Mail** > **Manage Mailboxes**.

## Example

The following bulk-import creates 3 addresses -- 2 on the login domain and 1 on an [[creating-addon-domain]] that is [[authorizing-hostnames-handle-e-mail]] to handle e-mail:

myadmin matt@apnscp.com sales matt, stan support@goap.is help, pager@att.net

Assuming the login domain is `example.com`, this creates:

1. **myadmin@example.com** forwards to matt@apnscp.com
2. **sales@example.com** forwards to matt@example.com, stan@example.com
3. **support@goap.is** forwards to help@example.com, pager@att.net
