Support & Training
All Categories Voters Importing Voters

Importing Voters

Adding voters to your election


Import CSV Template Details.

The quickest and easiest way to get started with importing voters into an online election is to download the voter import template by clicking here: This template file is in the CSV (Comma Separated Values) format which can be opened by all popular spreadsheet applications (Excel, Numbers, Google Spreadsheets, etc.). Starting from or using the template file is not required, but Choice Voting will only accept valid CSV files with the first row containing the following columns:


  • voter_name

  • voter_email

  • voter_restricted

  • voter_allowed

  • weight


If the first row does not have the above listed columns in the exact order and spelling, then the import will fail.


Column Info / Fields







The name field allows you to associate a name with a Voter Identifier. This is for your records and will only be seen by the voter if you choose to add an email address for the voter. This field is required.



The Email field will be used as a way to notify your voter when the election launches. If provided, the voter will receive an email with voting instructions as soon as your election starts. This field is not required and to be used must be enabled in the election’s settings. (settings > Email Notifications > Enable email)



It is possible to restrict your voters from certain positions in your election, you may specify as a comma separated string the positions you wish to restrict the voter from.



An alternative to restricting, is to simply specify the positions the voter is allowed to vote in, and the system will restrict all others for you.

Vote Weight


The Vote Weight field allows you to assign a weight to the voter’s ballot. If you do not have weighted voting enabled for your election, you can leave this column empty. By default, the voter’s vote weight is 1

How to Import your CSV


To import a list of voters on a correctly formatted CSV file to an election, follow the steps below:

  1. Click on “Voters” on the election sidebar.

  2. Click on the “Import Voters” button

  3. The “Import Voters” pop up will open and provide instructions for importing a csv file.

  4. Click “Choose File” and select the import file from the device

The import process will display any errors with the import file.



Additional Notes for uploading voters.


  1. Importing a list of voters will append the list to the existing list of voters in the election, unless you select the “Cleanup existing voters” checkbox. For example, importing the same list of voters twice will result in each voter being duplicated. Selecting “Cleanup existing voters” will replace the existing voters with the new uploaded voter csv.

  2. The import file must be a valid CSV (comma separated values) file.

  3. The default import limit is 30,000 voters. If your election has more than 30,000 eligible voters, please contact support.

Was this article helpful?