Getting your Data into Reach
We offer a “bring your own data” model where we will upload whatever data you provide us. That data will not be shared with other campaigns. It is up to you to make sure it is accurate and current and complete. We are happy to offer free data processing and upload at the launch of your campaign, and every two months after that. Any data updates before two months have elapsed since your last update will be billed at a rate equal to 1/3 of your monthly subscription fee.
Who Do You Want to Reach?
Think far and wide to Reach your goals! When thinking about which data set to chose, you want to capture the largest audience. If you’re an electoral campaign, this will probably be a voter file containing every registered voter in your district. If you’re a labor union, this might be a complete list of all your members or maybe a list of all the workers on a factory floor who you want to organize.
A note for electoral campaigns
What should be in the file?
Once you decide your audience, provide us with a CSV or TXT file of the those folks you would like to Reach. At the bare minimum, this file must include name information, location information (like street address, city, zip, and state), and at least one Unique ID (like a state voter ID, a VANID, or a member ID).
In order to optimize your Reach experience, include any other fields that might be useful in your canvassing interactions. This might include party affiliation, registration status, age, gender, last voted year, or anything else available. Include whatever you believe is the most useful information to Reach your goals, and we will load it up. This additional information will be displayed on the “Person Profile” screen that your users will see in Reach. Generally, we do not need things like scores or predictive calculated fields, as you won’t be using Reach for targeting or list-building.
These are the fields we’d recommend you include in the voter file you upload to Reach:
Note: If you are exporting data from VAN, the first step is to Create a List before exporting. Be sure to remove ALL suppressions from your list except for “Exclude Deceased”. Do not suppress data based on Registration Status, Good Voting Address, Good Mailing Address, etc.
- CRM ID (VANID, PDI ID, NationBuilder Signup ID, DWID, etc)
- State ID
- Any other UIDs (county, etc)
- Name Prefix
- First Name
- Middle Name
- Last Name
- Name Suffix
Broken into as many separate fields as possible. If you’re exporting from VAN make sure to select “Voting Address (Separate Fields)” as opposed to “Voting Address (Single Field)“.
- House Number
- Fractional House Number
- Pre Street Name Direction
- Street Name
- Street Type
- Post Street Name Direction
- Unit Type
- Unit Number
- Zip Code
Other Core Fields
- Birth Date (with 4-digit years). If unavailable, Birth Year is sufficient, but not Age
- Political Party
- Registration Status
- Registration Date
- Last Voted Date
- County Name
- Congressional District
- State Senate District
- State House District
- County Council District
- City Council District
- Any other districts
What about when new people register to vote?
We are happy to update your voter file any time you provide a new updated version. Subsequent updates and new versions of your data must include the same Unique ID that your original file included. For best and fastest results, the whole layout and should match from previous uploads. We will provide one free update every two months over the course of your subscription. More frequent updates can be done upon request and will be billed at a rate of 1/3 of a month’s subscription fee.
Where should you get the data?
We will take data from any source that can generate a CSV or tab-separated text file.
For electoral campaigns looking for voter data, many of our campaigns get their data directly from their state or county’s Board of Elections or Secretary of State office. In some states, this data is posted online for easy download. In other states, it is available to campaigns for low or no cost upon request. In other states still, it may be prohibitively expensive or complicated to obtain directly from the state.
If you have access to voter file data from an existing database or CRM like VAN or PDI and you have the ability to export that data freely, that works too. Keep in mind that in the case of VAN, this data is typically managed by your state Democratic party so your ability to export flat CSVs of the data will be controlled by the party’s data policies and procedures. We will always defer to the state party’s requirements for allowing these exports and we aim to strike a balance where they will feel comfortable approving the export as long as the number of requested fields is limited to only those relevant to Reach (see above). If someone from your state party has questions or concerns about Reach, they can contact us directly via [email protected].
If none of these options are available to you, we have relationships with well-established data vendors like Catalist, TargetSmart, and L2 who will sell you voter data with a steep discount if you’re going to be using it exclusively in Reach. For more information about this and pricing estimates, get in touch with us.
How to get your data to us
Email us and we’ll provide a secure link for uploading your data.
Please provide data in as raw a form as possible. If you’re using public data, send us exactly the file that the state sent you. If you’re exporting from VAN, send us the exact text file you exported. Do not open your file in Excel and manipulate the data and re-save as this almost always causes problems with Excel messing with the data formatting.
What about phone numbers?
We generally do not preload or bulk load phone numbers into Reach.
Our clients tend to think of Reach as a powerful data collection tool that enables them to collect good contact information for voters, whether it’s through users adding contact information while they use Reach for relational organizing, or while they’re interacting with voters directly. Many users will be much less inclined to message someone from Reach (using their own phone number) if it’s not a number that they themselves added.
It is, however possible for us to bulk-load phone numbers from a data source. We can do this upon request during an initial import for free, or as a subsequent special data project, billed at 1/3 the cost of your monthly subscription. Some major things to consider when thinking about this:
- Reach only shows users the single most recent phone number that has been added for any given voter. We do not currently support multiple phone numbers being visible on a given voter at a time. It is possible to change your privacy settings so each user sees only the most recent phone number that they themselves added and can’t see contact info collected by other users, but this would also mean no users would see any of the phone numbers we’d bulk load so it would totally defeat the purpose.
- Since we only support one phone number per voter, the phone numbers you want us to use must be consolidated into one column in the data.
- If your users have already begun adding phone numbers to Reach, those would be overwritten by a bulk import. We would strongly advise against an import like this because it is highly likely to confuse and frustrate users who already added the phone number they know is correct if it is later replaced by one that is more likely to be wrong. To solve this problem, we could back-date phone numbers we import so they appear as “older” than ones collected by your users and thus the user-provided phone numbers would take precedence.
- If your users continue to include phone numbers when they import their contacts into Reach, those will override and replace any numbers we bulk load.
- With default Reach privacy settings, our privacy masking feature would apply to imported phone numbers so all your basic Users would see a masked version of the phone number (like ***-***-9380). Therefore, a regular User would not be able to use Contact Actions to contact a voter from this data load. They would have to delete an existing number and replace it with new contact info. Your Verified Users would be able to see all contact information you’ve loaded here, and would be able to use it to contact voters via SMS/email.
If you do want us to bulk-load phone numbers, please be very explicit about this when sending in your file.