Imports
Your tour pages can show figures from day one, using the trips you’ve already run. Go to Species Log → Import. It has four tabs: eBird, Old reports and lists, Spreadsheet and History.
Every file is read in your browser. Only what’s needed (dates, guide names and bird names) is sent to your site, and the files themselves are never uploaded anywhere.
Guides’ own eBird downloads
Section titled “Guides’ own eBird downloads”For guides who log their trips in eBird. Ask each guide first: it’s their data.
Getting the file. The guide opens My eBird → Download My Data in eBird and presses Submit. eBird emails them a zip file, usually within minutes, holding every bird they’ve logged. They send you the zip as it is.
- Choose the file: the zip, or the CSV inside it. Under Whose eBird data is this?, choose the guide: they’re listed on the departures the import adds to. Countries is optional, to narrow a large file.
- Checklists and departures: checklists are matched to your departures by date, wherever they were made. Two departures on the same dates? You pick which. Checklists on dates with no departure are grouped into trips: pick a tour to load one as a past departure, or leave it. When several guides send downloads for one departure, their birds are combined in its one list.
- Check the birds: names that need a decision (see Names to check), then import.
eBird has no heard-only field, so a bird is counted as heard only when its eBird comment says “heard” or “H”. Many guides don’t note heard-only birds in eBird, so check these if it matters to you. Checklist locations and coordinates aren’t stored.
Approved lists are left alone unless you tick them, and they stay approved.
Old reports and lists
Section titled “Old reports and lists”For the birds in your old trip reports and species lists. (To write new trip reports, see Trip reports.)
- Choose the files: drop in PDF, Word (.docx), Excel (.xlsx), CSV, web page (.html) or text files, up to 500 at once, or a whole folder. Or paste a list copied from anywhere, one bird per line. For the whole batch you can set the tour (if every file is from the same one) and the guides (for files that don’t name them). How far back ticks the last few departures of each tour; you can tick any file yourself.
- Check the files: one row per list found, with the tour, dates and departure worked out from the file. Rows that need attention are marked: pick the tour, add dates, or create a past departure. What was read shows the file’s title, columns and marks. Each file’s own key is used to read marks such as “HO” (heard only), and you can change what a mark means.
- Check the names, then import.
Story-only trip reports and files that only link to eBird are listed and skipped. Scanned PDFs with no text can’t be read: use a copy with text in it. Old Word files (.doc) need saving as .docx first.
Extensions: if a list includes an extension’s birds, you can split the extension-only birds onto an extension departure, or keep one combined list. See Tours: Extensions.
The spreadsheet template
Section titled “The spreadsheet template”For lists kept anywhere else, or exported from your own system. Download the template on the Spreadsheet tab: a CSV with the headings and three example rows (skipped if you leave them in). One row per bird per departure; one file can hold any number of tours and departures.
| Column | What goes in it |
|---|---|
tour |
Required. The tour’s title, web address slug, or post ID. |
start_date |
Required. The departure’s first day. 2025-03-14 is safest; 14 Mar 2025 and 03/14/2025 are read too. |
end_date |
Optional. The last day; empty means the same as the start. |
species |
The English name. Or give a scientific name or eBird code instead. |
scientific_name |
Optional. Helps matching, especially for split species. |
ebird_code |
Optional, e.g. resque1. Matched first when present. |
seen |
yes or no (also y, x, 1). |
heard |
yes or no. “heard yes” without “seen yes” is heard only; anything else is seen. |
guides |
Optional. Names separated by semicolons. |
notes |
Ignored. For your own use. |
Save it as CSV or Excel (.xlsx). If the dates could be read either way (03/04/2025), you’re asked whether the day or the month comes first. Rows with a problem are listed and skipped.
Names to check
Section titled “Names to check”Old reports use old and misspelt names. Before importing, each tab lists the names that need a decision, grouped across all the files, so you decide each one once:
- No match or More than one species: pick the species, search, or leave the name out.
- Scientific and English names disagree: usually a typo in the scientific name; the English name is used, worth a glance.
- Split since: which one? An old name of a species that has since been split. For each tour, the default is the species logged on its other departures, or else the one that kept the scientific name. Pick one to use it everywhere.
Your choices are remembered for later imports. You can see or remove them on a species’ page in Species Log → Species.
Birds that weren’t on the bird list on a departure’s date (a species split later, say) aren’t added, and are listed after the import.
History and undo
Section titled “History and undo”The History tab lists every import: when, whose data, and what it added. Undo removes the sightings it added, the departures it created (unless birds were logged on them since), and the guide from departures it listed them on. Remembered names stay. For old reports, you can also undo one file at a time.
Bird names in Species Log come from AviList: The Global Avian Checklist, © 2026 AviList Core Team, licensed under CC BY 4.0. The plugin includes a shortened copy (only the columns it uses).
Our plugins are for WordPress; they aren’t made or endorsed by the WordPress Foundation or by eBird.