On every plan. Checked on Saturday, November 14, 2026.
A CSV file is a spreadsheet saved as plain text. Google Sheets, Excel and Numbers all open it and save it. With one, you can make a hundred addresses in one go, or change the forwarding of many at once, instead of one by one.
What the file looks like
The first line names the columns. Each line under it is one address.
| Column | What goes in it |
|---|---|
address | The whole address, like info@yourdomain.com. The only column you must have. Its domain has to be one of yours. A * before the @ is the domain's catch-all. |
name | The name on mail you send from the address, up to 100 characters. An empty cell means no name. |
forwards_to | The inbox it forwards to. An empty cell keeps the inbox it has; a new address then forwards to your sign-in inbox. |
active | yes to take mail, no to refuse it. An empty cell keeps it as it is; a new address takes mail. |
created | When the address was made. The export fills it in and the import leaves it alone. |
The export has a column for every setting an address has. Leave out any column but address: what a file doesn't mention stays as it is.
address,name,forwards_to,active info@yourdomain.com,Front desk,you@gmail.com,yes sales@yourdomain.com,Sales,,yes
Start from an export
- Open Addresses and press Export all (CSV). A domain's page has an export of that domain's addresses too.
- Open the file in your spreadsheet.
- Change what you need, add a line for each new address, and save it as CSV.
You can keep only the lines you want to change: an address that isn't in the file stays as it is. An import never deletes an address; do that on the Addresses page.
Import
- On Addresses, press Import CSV and choose the file.
- We check every line first and show what each one will do: a new address, a change, no change, or a problem on that line. Nothing changes yet.
- If a line has a problem, fix it in the file and choose the file again. Nothing is imported while any line has one.
- Press Import. Every line is saved together, or none is.
The rules
- Your plan's addresses. New addresses count against your plan the same as ones you make by hand. If the file would go past the number your plan includes, nothing is imported.
- A new inbox confirms first. An inbox you haven't confirmed before gets an email asking it to. Until it confirms, a new address forwards to your sign-in inbox and an existing one keeps its inbox. Once an inbox has confirmed, imports use it straight away.
- At most 20 forwarding changes in one import. That counts the addresses waiting for a new inbox to confirm and the ones moved to another inbox. Import the rest in a second file. Each address moved to another inbox sends you a security email, so you always know where your mail goes.
- Up to 1,000 addresses and 1 MB in a file. Split a bigger file and import each part.
- An export imported again changes nothing. The export puts a ' before a cell that starts with =, +, - or @, so a spreadsheet never runs it as a formula, and the import takes it off again.
The same data as JSON
Signed in to JULY Email, open /api/aliases to see your addresses as JSON, with the same fields as the file. /api/aliases/ followed by an address's id shows one, and /api/aliases/export is the CSV. They answer only to your own signed-in session. The import is at /api/aliases/import: send the file as text/csv, with ?dryRun=1 to check it only, or as JSON with csv and dryRun.
A question this doesn't answer? Write to hello@julyemail.com and a person on our team answers within one business day.
