The Election Assistant scans elections for missing or inconsistent data as well as configuration issues that may be overlooked by election administrators. The idea is to help identify common mistakes before an election is launched. The results of the scan do not prevent the election from being launched and can be safely ignored, though we recommend taking action on warnings and critical warnings.

Election Assistant

How it Works

The Election Assistant scan is triggered during step one of the election launch process). If no issues are detected during the scan, then the launch process will continue on to step two. Otherwise, a modal window with the scan results will be displayed. Clicking the green “Continue” button will proceed to step 2 of the election launch process.

Alert Levels

There are 3 “levels” for a result that correspond with its priority: Notice, Warning, Critical Warning.

TypePriorityInfo
NoticeLowA “Notice” is a low priority alert that relates minor consistency issues on the ballot and election settings.
WarningMediumA “Warning” is a medium priority alert that relates to configuration issues that should be attended to.
Critical WarningHighA “Critical Warning” is a high priority alert related to the integrity of the election. Fixing this type of alert is highly recommend. We require that the Election Administrator acknowledge their understanding of this notice by clicking a checkbox before being allowed to proceed with the launch process.

Scans

The Election Assistant currently runs the following scans:


Email Disabled with Voter Emails

This scan checks if the election email setting is enabled if at least one voter has an email address assigned to their record. If the email setting is enabled, this check will pass.

How to Fix
Enable email in the election settings (Settings > Email > Enable Email).
When to Ignore
Ignore this result if election does not require the email functionality.

Duplicate Voter Emails

This scan checks if a single email address is assigned to more than one of the election’s voters.

Why Fix
Having an email address assigned to more than one voter will allow the recipient to vote more than once in a given election.
When to Ignore
Ignore this result if assigning the same email address to more than one voter was intentional.
How to Fix
Use a unique email address for each voter (see: How to Edit a Voter).

Duplicate Voter Keys

This scan checks the voters list for voters sharing a Voter Key. The check will result in a “Warning” if it finds more than one voter sharing a single Voter Key. If all voters share the same Voter Key, then this will result in a “Critical Warning”.

Why Fix
To maintain the integrity of an election, we recommend using unique Voter Keys for every voter. Duplicate Voter Keys is a sign that the election administrator is using an easily identifiable pattern for voter login credentials. Ignoring this error could result in voters voting on behalf of other voters in the election.
When to Ignore
Ignore this result if the integrity of an election is not necessary (e.g. it’s a test election).
How to Fix
Use a unique Voter Keys for each voter (see: How to Edit a Voter).

All Ballot Questions Require Response

This scan checks the ballot to determine if all ballot questions require a response.

Why Fix
Requiring a response for every question on the ballot prevents voters from abstaining.
When to Ignore
Ignore this result if requiring a response for every question on the ballot was intentional.
How to Fix
Allow voters to abstain from voting for all questions on the ballot (see: How to Allow Voters to Abstain from Voting for Multiple Choice Questions).

Default Option Titles

This scan checks if any ballot questions have an option with a title that was not changed from the default title “New Option”.

Why Fix
Leaving the option title as “New Option” was likely unintentional.
When to Ignore
Ignore this result if the election is for testing purposes.
How to Fix
Change the title of a ballot question option from “New Option” (see: How to Edit an Option of a Ballot Question).

Duplicate Option Titles

This scan looks for ballot question options that share the same title/name.

Why Fix
Having more than one option with the same title on a given ballot question may make it difficult for a voter to determine which option is the option they intended on selecting. Additionally, the election’s results will only display an option’s title along with the total votes for each option. Election administrators do not have the ability to see an option’s photo or short/long description on the results. Making it impossible to determine which of the duplicate options correspond with the vote counts.
When to Ignore
Ignore this result only in cases where it’s not important for a voter or election administrator to distinguish the difference between one or more duplicate options.
How to Fix
Change the titles of the duplicate options (see: How to Edit a Ballot Question Option) or delete the option from the ballot question (see: How to Delete a Ballot Question Option).

Write-In Title Changed

This scan checks if any ballot questions have a write-in option that does not have the default title “Write-In”.

Why Fix
Changing the title of a write-in option may have unintended consequences with the election results as the title is not visible on the election results alongside the voter’s response (see: Write-In Fields)
When to Ignore
Ignore this result if changing the Write-In option title was intentional.
How to Fix
Change the title of the affected write-in field to “Write-In” (see: Write-In Fields and How to Edit an Option of a Ballot Question).

Question Options Missing Attributes

This scan checks the ballot for inconsistent usage of option attributes (short description, description, photo). The scan looks to see if the majority (>= 50%) of options on a question include values for the attributes. If it is determined that a minority of those options exclude a given attribute, a notice is shown.

Example 1
A given ballot question has 5 options. All options have a description, but only 3 have a photo and 4 have a short description. This would result in a notice that 2 options are missing a photo and 1 is missing a short description.
Example 2
A given ballot question has 4 options. One option has a photo, two have a short description and none have a description. This would result in a notice that 2 options are missing a short description. Because a majority of options do not have a photo or description no notice is shown for those fields.
Why Fix
Inconsistent usage of option attributes on a ballot question can result in some options being preferred by voters over those lacking the attributes. It’s also important to note that ballot question options cannot be updated once an election has been launched (see: The Different States of an Election).
When to Ignore
Ignore this result if the decision to leave information out for ballot question options was intentional.
How to Fix
Provide additional information for the affected ballot question options. Alternatively, delete the values provided for those options with the attributes defined (see: How to Edit an Option of a Ballot Question).

Weighted Voting Disabled

This scan checks if weighted voting is enabled in the election settings. If the setting is disabled and at least one voter has a vote weight greater than 1, then the check will fail. If the weighted voting setting is enabled or all voters have a vote weight equal to one, then this check will pass.

Why Fix
Vote weights will not be applied to ballots if weighted voting is disabled (see: How to Use Weighted Voting).
When to Ignore
Ignore this result if the decision to leave weighted voting disabled was intentional.
How to Fix
Enable weighted voting in the election settings (see: How to Use Weighted Voting) or set the vote weight to 1 for all voters (see: How to Edit a Voter)

Voter Credentials Include Email Address

This scan checks the voters list for voters that have an email address in the Voter ID and/or Voter Key field and not the email address field.

Why Fix
Voters with an email address as the Voter ID and/or Voter Key will not be sent the voting instructions/reminders if the email is not provided in the email address field.
When to Ignore
Ignore this result if the decision to use a voter’s email address as their Voter ID and/or Voter Key and they should not receive an email with voting instructions.
How to Fix
Provide an email address for voters without an email address (see: How to Edit a Voter) or disable email in the election settings (Settings > Email).

Election Duration

This scan checks to see if the election’s voting period will be open for less than one hour or more than 30 days.

When to Ignore
This scan is only intended to bring attention to the uncommon scenario of an election being open for longer than 30 days or less than one hour. This notice can be safely ignored if the start/end date and time set by the election administrator is correct.
How to Fix
Change the start/end date and time in the election’s settings (see: How to Update Election Dates)

Ranked Choice Question Options Count

This scan checks to see if the ballot has any Ranked Choice questions with more than 15 options.

Why Fix
Ranked Choice questions with more than 15 options results in a poor voting experience for voters on mobile devices.
When to Ignore
Ignore this result if it’s necessary to have more than 15 options on a Ranked Choice ballot question.
How to Fix
Delete additional options from the ballot question (see: How to Delete a Ballot Question Option).

Ranked Choice Question Usage

This scan checks the ballot for the presence of a Ranked Choice (IRV) question type.

Why Fix
The results of a Ranked Choice (IRV) question need to show each option ranked 1st through Nth (1st, 2nd, 3rd, 4th, etc.). Ranked Choice (IRV) is designed to find a single winner. (see: Ranked Choice IRV)
When to Ignore
Ignore the results of this check if selecting the Ranked Choice (IRV) question type was intentional and the format of the results for this question type is fully understood.
How to Fix
Delete the Ranked Choice (IRV) question(s) from the ballot and add a new Multiple Choice question with the same list of options.