When you upload data, it must be saved as a comma separate file (.CSV). There are five different ways to import a .CSV file. All fields available for import are listed below. Every import must include a unique identifier. An asterisk indicates a unique ID field.

Fields that can be imported are categorized. You can search for field names when mapping your fields, but not for the category names. Some fields exist within multiple categories, so take care to map the correct field to your data. If a field can only be imported using a particular importer, that is noted.

We strongly recommend not using fields as proxy for other information. Extra data points can be added as tags. In some cases, it may make sense to create custom fields. Please contact your community strategist or help@nationbuilder.com to discuss if this option is right for you.

Table of Contents

Most Frequently Used

This category includes the fields most frequently used in that importer. The following fields are included in this category in the people import found at People > Import > One time import.

Signup

Within the code, a person or organization in your nation is referred to as a "signup." People in your database do not have to sign up on your website to be considered a signup. It is simply a way to distinguish a person from a webpage or another aspect of your nation. Most other field categories are actually sub-groupings of signup fields. The distinction between people and organizations is made using the signup type field. 

Address

The fields in this category will create a home address for the profile. Do not use these fields for an organization. An organization's address should be mapped to work address.

One of these fields must be included in the import for the address to be created: address1, city, or country_code. 

Existing addresses will be overwritten if the overwrite box is checked and one of the following fields is mapped: address1, street_name, city, zip5, or country_code.

Mailing address

If you use the address1, address2, and address3 fields, the information will be parsed into the street name, street number, street prefix, street suffix, street type, and unit number fields. Therefore, either map address1, address2, and address3 fields or map street name, street number, street prefix, street suffix, street type, and unit number. Similarly, either map to the zip field for a mailing address postal code or map to zip4 and zip5. 

One of these fields must be included in the import for the mailing address to be created: address1, street name, city, zip5, or country code.

Media market

Precinct

A precinct is the smallest unit of organization for a campaign. Each precinct is a defined as the unique combination of precinct_code and precinct_name. Precincts are never included in auto-districting.

Recruiter

The person who introduced your nation. A profile for the recruiter must already exist in your nation. All fields within this category refer to the recruiter. To ensure the correct person is credited with recruiting the person, try to use the recruiter's email address or NationBuilder ID. 

In a donation import, the recruiter category is listed twice. While this is confusing, please be aware that the categories are distinct. The first recruiter category is for the person who introduced your nation. The second recruiter category is for the donation's fundraiser. Recruiters and fundraisers must have profiles in your nation before the import begins.

During a donation import, if you map to only one set of recruiter fields, the person will be listed as both recruiter and fundraiser. This is true regardless of which category you map. If you map to both categories, you can import a recruiter and a fundraiser for each donation. If a donation is imported without a fundraiser, the donor will be listed as the fundraiser.

Registered address

The address where the person is registered to vote. You have the same options for this address as you do for mailing address - either map address1, address2, and address3 or map street name, street number, street prefix, street suffix, street type, and unit number. Similarly, either map to the zip field for a mailing address postal code or map to zip4 and zip5. 

One of these fields must be included in the import for the registered address to be created: address1, street name, city, zip5, or country code.

If you only map registered state or registered state and registered county fields, the registered address will not be updated. Those fields will be used with state file ID or county file ID to define a unique identifier in the import / match in your people database.

Work address

When importing organizations, always map physical location to these fields. 

One of these fields must be included in the import for the work address to be created: address1, street name, city, zip5, or country code.

Donation

This category is only available when doing a donation import. A donation import is used to import records of individual amounts donated at can be started from Finances > Donations > Import. If you map the tag_list field in a donation import, the donor's tags will be overwritten by the tags imported. This only happens during a donation import. During all other imports, the tag_list appends tags to a person's profile. Donations made by organizations can also be imported. Use the signup_type field to indicate that a donor is an organization. 

If you are trying to import a list of donors without individual donation records, use the one-time import found at People > Import > One-time import.

Ballots

These fields are only available in a ballot import. Voters must exist in the nation before ballots can be imported.

Billing Address

You can only import a billing address during a donation import. A donation import is used to import records of individual amounts donated at can be started from Finances > Donations > Import.

One of these fields must be included in the import for the billing address to be created: address1, street name, city, zip5, or country code.

Election

These fields are only available in a ballot import. Voters must exist in the nation before ballots can be imported. These fields define the election within which a ballot was cast. 

Election periods

Both fields are available in donation imports. The name field is also available in ballot imports

These fields allow political campaigns to attribute donations to a particular election period. Proper attribution requires mapping both the election_cycle and one of the below fields. A donation import is used to import records of individual amounts donated at can be started from Finances > Donations > Import.

During a ballot import, the election period name defines what type of election occurred. 

Payment type

These fields are only available in a donation import to indicate how payment was received. A donation import is used to import records of individual amounts donated and can be started from Finances > Donations > Import.

Membership

Go to Settings > Defaults > Membership types > Import memberships to import memberships.

Paid memberships must be imported as two separate files: membership information and transaction information. 

Please note that memberships are only available to those on the Team plan or above. If you would like memberships activated in your nation, please contact help@nationbuilder.com.

Voter history

Voting features must be enabled at Settings > Defaults to access these fields. We recommend importing these fields when importing voters at People > Import > Voter file.

These fields can also be imported as part of a ballot import

Related HOWTOs

Fields available for import (old)
How to import

Did this answer your question?