Our CSV and Excel file guide – importing prospects

If you wish to upload the database from a file, you can do it using a .csv, .xls or .xlsx extension.


How to create CSV or Excel file
How to import a file to Woodpecker

CSV stands for Comma-separated value. CSV file format uses a comma as a field separator and a new line as a new data record. Woodpecker uses CSV files to import and export the data. You can export your sheet to a CSV file from any web or desktop sheet editor.

Please make sure your Sheet program is configured to use UTF-8 coding. Some programs such as Microsoft Excel make it difficult to export a properly coded CSV file. For that reason, we advise using Google Sheets in the process.

How to create CSV or Excel (XLSX, XLS) file?

1. Prepare your spreadsheet

You can use Google Sheets, Excel or Libre Office, for example. Woodpecker considers an email address as a unique contact ID, please include a single email address per row and one data entry per cell. Here are some of Woodpecker fields that you can find in the App: First Name, Country, City, Phone, Company, Email (required), Title, Last Name, Website, and snippets.

2. Download your sheet as CSV, XLSX or XLS file

In Google Sheets, click File Download as Microsoft Excel (.xlsx) or Comma-separated values.

csv-excel-file-import-prospects image

An example of the exported CSV file:

csv-excel-file-import-prospects image

Opening and saving the downloaded file through notepad may clear the text from diacritic signs such as ć, ż, ó. You might want to check if your program is configured to use UTF-8 coding.

How to import a file to Woodpecker

Limitations: please mind adding an Excel file that is bigger than 5 MB is not possible.

1. Open your campaign, click “Add prospects” → “Import”.

When your CSV, XLS or XLSX file is ready, you can import it to Woodpecker. You can add your contacts to the Prospects database or straight to your campaign. When adding prospects to the campaign, don’t switch to the Prospects database!

csv-excel-file-import-prospects image

If you’re editing a campaign, scroll down to the PROSPECTS.

  • Click to expand the section.
  • Click ‘Add prospects’ → and select ‘Import’.

csv-excel-file-import-prospects image

2. Next, click “BROWSE”, select your file and hit the button “UPLOAD AND IMPORT”.

csv-excel-file-import-prospects image

3. Map Woodpecker fields to those in your spreadsheet.

  • Any unmapped fields won’t be imported.
  • If the first row contains column headers, check “Ignore the first row when importing”, right below.
  • When this is done, don’t forget to click “IMPORT”.

csv-excel-file-import-prospects image

4. Click ‘ ADD‘ to finish importing your file.

csv-excel-file-import-prospects image

Check our help Adding prospects to Woodpecker to learn more.


You’re receiving an error while trying to import your prospects to Woodpecker.

Download the error file and check it. There you will see the fields which couldn’t be mapped correctly. Make sure you don’t include the column “STATUS” with values like “Verified” or “Non-verified”. As a status, you can use only statuses available in Woodpecker. Learn more about our statuses »

You’d like to add the same prospects to another campaign. It doesn’t work and shows duplicates.

Sometimes you may want to add already existing prospects to a new campaign. Here’s the detailed instruction on how to add duplicates.

Prospect list takes a long time to load.

Clean your browser history and cache. You can also switch to Mozilla Firefox, as it proved to work better with Woodpecker.

Turn knowledge into results

Send follow-ups that make a business thrive