Import Subscribers from File

Import Subscribers 

Zoho Campaigns allows you to import subscribers from other sources into a mailing list. Before you begin importing subscribers, make sure that you've created a mailing list to save the data.

In this guide, you’ll learn the different ways to import subscribers from various sources, which file formats are compatible, possible error scenarios and finally understanding the import history.


Which file formats can be used to import subscribers?

You can Import Subscribers using either of these common spreadsheet formats:

  • .xls, .xlsx (Excel documents)
  • .csv (Comma separated value files) 


  • Text files are not supported for subscriber imports.
  • Email address is a mandatory field.

What is an Excel file?

Excel (.xls and .xlsx), is a spreadsheet that arranges data in rows and columns. Each record should be stored in a single row with its fields in different columns. An ideal excel sheet for import should look like this:

What is a CSV file?

CSV files, as the name suggests, are files where data is listed as one record per line and each field is separated by a comma. A simple subscriber.csv file would look like this:


The first line is the header, which defines the field names. In this case, the headers are Subscriber Email, First Name, etc. Each line is a single person in your subscribers list with a corresponding name and email address.

Line breaks 

It is important that a CSV file must have one record per line, otherwise the system will not accept your file.


Make sure the fields are separated by commas. When 2 fields are not separated by a comma, the file will not be imported.

What problems can arise while importing Subscribers?

If you see an error message when importing files to your Zoho Campaigns account, it means there is an issue with your file, preventing its import. In this case, you should review your files and fix any errors.

Below are some different scenarios that can cause errors which prevent import:

  • Missing “@” symbol – For example, "" is missing the “@” symbol.
  • Missing "." – For example, "Patrick@yahoocom" is missing the period.
  • Spacing in File – This could be due to the extra space present in the beginning of your subscriber list. The best way to prevent this error is to make use of the TRIM function to remove all spaces from the text.
  • Email address with more than 6 characters after the last dot — For example, jane.doe@zylker.incostica
  • Non-English characters

Tips to remember when importing subscribers (Excel)

  • First row in a given file will be treated as field names.
  • Column headers should not exceed 255 characters.
  • File size should not exceed 30 MB.
  • Avoid using hyperlinks in email addresses.
  • Add email addresses under the appropriate column headers only.
  • When saving an Excel file, the format should be saved as MS Excel 95 or later.
  • When importing an Excel file, make sure to keep subscribers on one sheet.
  • Unexpected errors may occur if an XLS file contains any special controls, combo filters, or images embedded within it.
  • Checkbox field value should be true or false.
  • Date values must be in mm/dd/yyyy format. Dates in any other format will be ignored.
  • DateTime values must be in mm/dd/yyyy hh:mm:ss format. Date Time values in any other format will be ignored.
  • By default, character encoding is UTF-8 (Unicode). Make sure you provide the correct character encoding if your import file requires a different character code.
  • We recommend that you test your import with a sample file before you import the actual data.
  • Though we support Excel files, there is a possibility that it may not work due to other unknown errors. If this happens, we suggest converting your Excel file to a .CSV file and trying the import again.

How do I import subscribers from a file?

Before you import subscribers, make sure to create a mailing list so that you can save the imported subscribers to a recognizable file.

Importing subscribers from file

  1. From the Navigation toolbar, choose Subscribers and select All subscribers.

  2. Click Add, then select Import Subscribers.

  3. Choose a .csv or an excel file by clicking and dragging the file to the specified space.
  4. Select which mailing list you’d like to import subscribers to.

  5. Click Upload.

How can I view Import Overview?

The Import Overview page contains all of your imported subscribers' details. You can view a generated report on your subscribers after the import is complete. Zoho Campaigns makes it easy to view the entire history of imported subscribers in a single step.

  • From the Import Overview page, you can view the number of newly added subscribers, duplicate subscribers, and ignored subscribers. Just click one of the numbers to view the related subscriber details.

Why are some of my subscribers ignored?

There are a few reasons why you may see some subscribers excluded from your list:

  1. Bounced - Mail was undeliverable to the subscriber or the email address doesn't exist.
  2. Blocked - Subscribers blocked by Zoho Campaigns.
  3. Do-Not-Mail - Subscriber has been moved to do-not-mail registry.
  4. Group Email(s) - Subscriber address is generic. E.g., info@, administrator@, careers@, service@, support@, etc.
  5. File Duplicate(s) - Subscriber is present more than once in the file.
  6. Invalid Pattern - Subscriber has an with invalid address. E.g., "", "jane@aol", "ted@zylkercom"
  7. Empty Email- Subscriber's email address field is empty.
  8. Other Errors - Subscribers categorized as miscellaneous and don’t fall into the above-mentioned categories.

Why aren't group email addresses accepted while importing? 

Zoho campaigns restrict the import of group email addresses such as,,, and These email addresses have a high probability of email getting landed in the spam folder.

Share this post : FacebookTwitter

Still can't find what you're looking for?

Write to us: