NeurelectNeurelect
Get Started

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.

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

Step 1

Get a voter list from your Supervisor of Elections

Contact your county or city 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.

What to ask for
  • -A list of all registered voters in your jurisdiction (city, district, etc.)
  • -Make sure the file includes a voter_id column (sometimes called voter registration number)
  • -Request CSV format if possible — Excel files will need to be saved as CSV first
Step 2

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 "City of Richmond - 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.

Step 3

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.

File requirements
  • -CSV format with a header row
  • -Must include a voter_id column (case-insensitive, spaces and underscores are flexible)
  • -Maximum 200,000 rows per import
  • -Maximum 50 MB file size
Done

Your list is ready

Once the import finishes, your list is ready to use for walk packets, surveys, vote-by-mail tracking, and any other campaign workflows.

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. 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 don’t match any registered voter in your jurisdiction are counted as “not found” in the import summary. This can happen if the voter has moved, been purged, or if the ID doesn’t match the state’s format.