Import Custom Voter Lists
Neurelect includes statewide voter data, but some jurisdictions — particularly city municipal boundaries — may not be available as built-in filters. When you need voters for a specific city or district that isn’t natively supported, you can import them directly from a CSV file provided by your Supervisor of Elections.
An import uses voter IDs to add matching Neurelect records to a user-created list. It does not create new voter profiles, replace voter data, or expand your campaign’s jurisdiction access. Other CSV columns do not replace names, addresses, or phone numbers in Neurelect.
Owners and managers can import voters. Save Excel files as CSV before uploading.
When to use CSV imports
- Your campaign covers a city or municipality whose boundaries aren’t in Neurelect’s jurisdiction data.
- Your Supervisor of Elections provides an official voter roll that you need to work from.
- You have a custom list of voter IDs from another source and want to create a targeted list in Neurelect.
How it works
Get a voter list from your Supervisor of Elections
Contact your county Supervisor of Elections office and request a voter file for your jurisdiction. Most offices provide this as a CSV or Excel export.
This is especially useful for city municipal elections where the official municipal boundaries may not be available in Neurelect. Your Supervisor of Elections will have the definitive list of registered voters within the city limits.
- -A list of all registered voters in your jurisdiction (city, district, etc.)
- -Make sure the file includes a
voter_idcolumn (sometimes called voter registration number) - -Request CSV format if possible — Excel files will need to be saved as CSV first
Create a voter list in Neurelect
Navigate to Lists in your campaign dashboard and create a new voter list. Give it a descriptive name like "Fernandina Beach - Municipal Voters" so your team can find it easily.
This list will be the container you import voters into. You can also import into an existing list if you want to append voters to one you have already created.
Upload your CSV and import voters
Open your list and select Add Voters from CSV from the list actions menu. Drag and drop your CSV file or click to browse.
Neurelect will automatically detect the voter_id column and match each row against registered voters in your jurisdiction. The import summary will show how many voters were added, how many were already in the list, and how many could not be found.
- -CSV format with a header row
- -Must include a
voter_idcolumn (case-insensitive, spaces and underscores are flexible) - -Maximum 200,000 rows per import
- -Maximum 50 MB file size
Your list is ready
Review the import summary and list membership. You can then create walk packets or select the list as an audience for an SMS survey.
Frequently asked questions
What if my CSV uses a different column name for voter ID?
The importer recognizes common variations like Voter ID, voter_id,
VoterID, and Voter Id. Spacing, casing, and underscores are handled
automatically. If your file uses a completely different column name, rename the
header to voter_id before uploading.
Can I import into an existing list?
Yes, into a user-created list. CSV imports are append-only — voters already in the list are skipped, and new voters are added alongside the existing members.
What happens if a voter ID isn’t found?
Voter IDs that do not match Neurelect records within your campaign’s jurisdiction are counted as “not found”. Check the ID format and campaign jurisdiction first. An unmatched ID alone does not establish that a voter moved or was removed from the voter roll.
Does an import keep my list up to date automatically?
No. Importing adds matching voters at that time. A later import adds new matches but does not remove existing members who are absent from the new file. Review membership before using the list for a new round of outreach.
Next, create walk packets to assign door-to-door work.