> ## Documentation Index
> Fetch the complete documentation index at: https://docs.theculpernetwork.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Uploading Voter Lists

> Bring your own voter data into Culper via CSV upload.

If you have a voter list from your county party, a data vendor, or a previous campaign, you can upload it directly and use it for walks, outreach, and targeting — just like the built-in voter universe.

## Supported formats

* **CSV** (.csv) — any delimiter, any column order
* **Excel** (.xlsx) — first sheet is imported
* Column headers are auto-detected (Culper maps them using AI-assisted matching)

## How to upload

1. Go to **Dashboard → Lists → Upload List**
2. Drag and drop your file or click to browse
3. Culper shows you a column mapping preview — confirm or adjust each field
4. Click **Import**

The import runs in the background. You'll get a notification when it's ready.

## Column mapping

Culper auto-detects common column names from NGP VAN, L2, i360, and standard county exports. Common mappings:

| Your column                         | Maps to                                         |
| ----------------------------------- | ----------------------------------------------- |
| `VUID`, `StateVoterID`, `Voter ID`  | State Voter ID (used to match existing records) |
| `FNAME`, `First Name`, `first_name` | First name                                      |
| `LNAME`, `Last Name`                | Last name                                       |
| `DOB`, `Birth Date`, `BirthYear`    | Date of birth                                   |
| `PHONE`, `Cell`, `Mobile`           | Primary phone                                   |
| `EMAIL`                             | Email address                                   |
| `ADDRESS`, `Street Address`         | Street address                                  |
| `PRECINCT`, `Pct`                   | Precinct                                        |

If a column can't be mapped automatically, you'll be asked to map it manually or skip it.

## Matching to existing voters

Culper tries to match uploaded voters to existing records by **State Voter ID (VUID)**. If matched:

* The uploaded attributes (phone, email, notes) are layered onto the existing voter record
* Walk history, annotations, and survey responses are preserved

Unmatched rows are imported as new voter records scoped to your campaign only.

## Privacy & data scoping

Uploaded lists are **campaign-private** — only your campaign and the Culper team can see them. They are never shared with other campaigns on the platform.

<Warning>
  Make sure you have the legal right to use any voter list you upload. Culper complies with all applicable data use agreements — you are responsible for the data you bring in.
</Warning>