How Voter IDs/Keys Work

When you add a voter you have the option of specifying a Voter ID & Voter Key. These two fields can be thought of as a unique username and password that is assigned to each voter. to login using this ID/Key pair before they can see the ballot and submit their vote.

Voter Email Addresses

Adding an email address for a voter provides them with an alternative way of accessing/voting in your election. If you specify an email address for your voters, they will be notified via email when your election starts. The email will provide instructions on how to vote and a direct link to the voting page where they can enter their “Voter Key” and login to vote.

Importing Voters

If you have a lot of voters, then you may find it easier to bulk import them into your election. For information on how to import voters, please click here.

Voter Fields

When adding a voter to your election you can provide information for the following fields.

Field Column Description
Name name 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 not required.
Voter Identifier voter_identifier The Voter Identifier (Voter ID) is what can be considered as the Voter's "username". The voter will use this field when logging in to vote for your election. This field is not required, and if left blank a random value will be generated. A voter's Voter ID must be unique in your election.
Voter Key voter_key The Voter Key is what can be considered as the Voter's "password". The voter will use this field when logging in to vote for your election. This field is not required, and if left blank a random value will be generated.
Email email 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.