When importing a file of profile or contact information, you are bringing external data into your Organizer account, and Organizer will automatically attempt to match your imported data to Atlas by Murmuration data. If a match is made, the profile in Organizer will combine the information you imported as well as the enriched dataset from Atlas including vote history and model scores. Note, the information you import is not added to Atlas by Murmuration nor is it shared outside of your account without your permission. Review our Data Security Article for more information.
You can increase the likelihood that the matching process is successful by carefully preparing your import file according to the requirements and recommendations listed below. When you are finished preparing your file, refer to Import Your Data. If you are interested in importing outreach data, refer to Importing Phone Interactions or Importing Text Interactions.
File Requirements and Recommendations
- Data you plan to import must be saved as a CSV file type.
- Organizer Imports are limited to 500 MB file size.
- For files with more than 1,000 data records (i.e., rows), we recommend that you reach out to Support to request help with reviewing, cleaning, and uploading.
- You must include first name, last name, and contact information for each data record (i.e., row) in your CSV file; see details in Minimum and Recommended Source Mapping and Matching Logic.
- Each row must correspond to a person, and each column must represent a specific data field associated with that individual. Column names must be unique.
- Your CSV should include a value in every row where applicable and valid formatting for every value (see the Valid Formatting table below).
- Custom Attribute values are case sensitive and a mismatch will cause an error. For example, if you had a custom attribute for t-shirt color with the options “Red”, “Black,” and “Green.” And you included values in your CSV for “red,” “black”, and “green”; these lowercase values would not match to those options set in the custom attribute. Learn more in Create Custom Attributes through Imports.
- If your file has multiple columns for phone numbers and emails, you will need to perform several imports because the Phone Number and Email fields can each be used only once per import.
Valid Formatting
The table below shows the acceptable format for each destination field in Organizer when mapping attributes (i.e., columns) associated with each record (i.e., row) in your import. The column "Dependent Field Selection" indicates information you need to include as a column in your file or you can enter a global value during the import process; for example, if you include City you will also need to include the State.
You do not need to include every attribute in the table in your import, but if you choose to include any of the attributes below, you must format them as described in the "Accepted Values" column of the table. In the table, “open text” is used often as an accepted value; open text refers to any combination of ASCII letters and numbers. In some cases, apostrophes or hyphens are allowed in specific fields; apostrophes should be formatted as “straight” or “plain” and avoid “smart” or “curly” apostrophe.
See the Data Dictionary for definitions of each attribute.
| Attribute Name | Accepted Values | Dependent Field Selection |
|---|---|---|
| Address 1 | Open text | State |
| Address 2 | Open text | |
| Address Contact Type | Unknown, Personal, Professional, Voter Registration | |
| Address State | US State Abbreviation (e.g., PA, NJ, TX) | |
| Address Type | Residence, Mailing, Commercial, Unknown | |
| Address Usability | Usable, Unknown, Hostile, National Do Not Use, Requested Do Not Use, Inactive Or Disconnected, Other Unusable, Unreliable Information | |
| Age | Any number | |
| Census Block | Open text | Census Block Group |
| Census Block Group | Open text | Census Tract |
| Census Tract | Open text | Census County |
| Children Present | True/False | |
| City | Open text | State |
| City District | Open text | City |
| Community College District | Open text | State |
| Congress Number | CN117, CN118, CN119 Data for CN120 (2027-2029) cannot be imported |
Congressional District |
| Congressional District | Two Digit Numbers such as “01” or “08” - See Acceptable Congress District Values | State |
| Contact Consent- Email | Opt-In, Opt-Out, Unknown OptIn, OptOut, Unknown |
|
| County | Open text | State |
| County Board of Education | Open text | State |
| County Commissioner | Open text | State |
| County FIPS | Open text | |
| County Voter ID | Open text and/or numbers | |
| Current Student | True/False | |
| Date of Birth |
Any of the following formats: MM/DD/YYYY MM/DD/YY YYYY-MM-DD MM-DD-YYYY Mon DD, YYYY (e.g. Feb 2, 2025) Month DD, YYYY (e.g. February 2, 2025) |
|
| Deceased | True/False | |
| Dwelling Type | Multi-Family, Single-Family, Unknown, Apartment, House | |
| Dwelling Estimated Value | Any number, no commas, no dollar signs ($) | |
| Education Level | No High School Diploma, High School Diploma, Some College, Associates Degree, Bachelors Degree, Graduate Degree, Masters Degree, Doctoral Degree, Unknown | |
| Email Address | exampleemail@domain | |
| Email Contact Type | Unknown, Personal, Professional, Voter Registration | |
| Email Usability |
Usable, Unknown, Hostile, National Do Not Use, Requested Do Not Use, Inactive Or Disconnected, Other Unusable, Unreliable Information
|
|
| Ethnicity | AAPI, Black, Hispanic, Middle Eastern, Native American, White, Other | |
| External ID | Open text and/or numbers according to the External IDs that have been added by users | |
| Field of Study | Open text | |
| First Name | Open Text plus hyphens and apostrophes | |
| Gender | Female, Male, Other, Gender Expansive | |
| Graduation Year | Four digit year | |
| High School District | Open text | State, County |
| Household ID | Open text and/or numbers | |
| Income | Any number, no commas, no dollar signs ($) | |
| Income Type | Household, Personal, Unknown | |
| Is Head of Household | True/False | |
| Judicial Circuit | Open text | State |
| Last Name | Open Text plus hyphens and apostrophes | |
| Latitude | Open text and/or numbers/symbols | |
| Longitude | Open text and/or numbers/symbols | |
| Marital Status | Single, Married | |
| Middle Name | Open Text plus hyphens and apostrophes | |
| Military Status | Military, Non-military | |
| Nielsen DMA | Open text | |
| Own/Rent | Own, Rent, Unknown | |
| Phone Contact Type | Unknown, Personal, Professional, Voter Registration | |
| Phone Number | Up to 13 digits | |
| Phone Type | Unknown, Landline, Mobile, Fax, VoIP | |
| Phone Usability | Usable, Unknown, Hostile, National Do Not Use, Requested Do Not Use, Inactive Or Disconnected, Other Unusable, Unreliable Information | |
| Registered Party | Democratic, Republican, Green, Libertarian, Conservative, Unaffiliated, American Independent, No Labels, Peace and Freedom, Constitution, Nonpartisan, Unknown, Other, Not Reported | State, Voter Registered |
| Precinct | Open text | State, County |
| Profile ID | Profile ID is the unique identifier in an Organizer account and can be found when exporting the profile or in the single profile view. Profile ID is usually formatted as: 8 character-4 characters-4 characters- 4- characters-8 characters. Murm ID is the unique identifier for an Atlas record. It can also be used as a profile ID. Murm ID format: M-12 characters. | |
| Registration Date |
Any of the following formats: MM/DD/YYYY MM/DD/YY YYYY-MM-DD MM-DD-YYYY Mon DD, YYYY (e.g. Feb 2, 2020) Month DD, YYYY (e.g. February 2, 2020) |
|
| Religion | Jewish, Catholic, Protestant, Mormon, Islamic, Buddhist, Hindu, Shinto, Sikh, Lutheran, Eastern Orthodox, Greek Orthodox, Christian | |
| School District | Open text | State, County |
| School/Institution | Open text | |
| State | US state name or state abbreviation | Country |
| State Board of Education | Open text | State |
| State Lower House | Open text | State |
| State Registered | US state name or state abbreviation | |
| State Upper House | Open text | State |
| State Voter ID | Open text and/or numbers | State, Voter Registered |
| Suffix | Open text | |
| Title | Open text | |
| Township | Open text | State |
| Voter Registered | True/False | |
| Voter Status | Active, Inactive, Unknown | |
| Ward | Open text | City, State |
| Years Resided | Four digit year | |
| Zip Code | Five digit number |