glossary
Defines election-related terms used in the OpenElections admin and project documentation.
What this file does
Defines election-related terms used in the OpenElections admin and project documentation.
When to use it
- Contributing to the OpenElections project
- Writing documentation that references election result types
- Onboarding new team members unfamiliar with election terminology
- Reviewing or auditing election data entries
layout: default title: OpenElections Glossary permalink: /glossary/
OpenElections Glossary
These terms are used within the OpenElections admin and the project generally.
Absentee Results
Voters unable or unwilling to vote at polling stations on Election Day can vote via absentee ballots. One source of absentee ballots is the population of Americans living outside the United States.
Certified Election Results
Certification occurs after a local or state canvassing board finalizes the election results and declares an official winner. State statutes may authorize local canvassing boards to issue certificates of election for local offices. State canvassing boards or other state officials issue certificates of election for multi-district, state, and federal offices.
Congressional
Congressional is an umbrella term that means the U.S. House and U.S. Senate. House and Senate refer to the specific chamber.
Congressional District Reporting Level
Results tabulated by congressional district for a state-wide or federal race. A congressional district is an electoral constituency that elects a single member of congress.
County Reporting Level
Results tabulated by county for a federal, state-wide or district race.
Direct Link
A link to the page where election results data for a specific race can be accessed.
End Date
The date an election ends. Most elections, but not all of them, begin and end on a single day.
FEC Clearinghouse
The Federal Election Commission site that provides an overview of election policies, activities, and (for our purposes) a page that links to each state's local elections management entity where election results are archived. Detailed information about each one is provided, including address and all primary contacts.
FOIA - Freedom of Information Act or similar.
A FOIA request is a formal public records request, which we may need to make in certain states to get access to elections data. In some states such requests are known by different names.
General Election
An election that usually determines the occupant of a seat. Usually held in November.
Governor
The governor heads the executive branch in each state or territory and, depending on the individual jurisdiction, may have considerable control over government budgeting, the power of appointment of many officials (including many judges), and a significant role in legislation.
Open Primary
A primary election in which candidates appear on a single ballot, regardless of party affiliation, and voters are allowed to vote for any candidate. In many cases, the top two vote-getters, possibly of the same party, advance to the general election. In some instances, a candidate who receives more than 50 percent becomes the winner.
Portal Link
A link to the page on a state's official election website that has an overview of election results (if there are several levels of pages, use the page that is one level above where you can access the results for a specific race).
Precinct Reporting Level
Results tabulated by precinct for a federal, state-wide or district race. A precinct is the most granular level or reporting.
Primary Election
An election that narrows the field of candidates before an election for office. Most, but not all, primaries are held among candidates of the same political party.
Provisional Results
Provisional ballots are for would-be voters who assert that they are registered but whose names cannot be found in the official list available at a polling place. The voter completes a written ballot, which is placed in a sealed envelope. The ballot is opened and counted only if the voter is subsequently found to be registered.
Race Type
The possible types of elections: Primary, Runoff, General and Recall. Special primaries, generals and runoffs are often held outside of the normal election cycle when a seat becomes vacant (See "Special Election" for more details).
Race-wide Reporting Level
Overall totals for a race, regardless of its geographical boundaries.
Recall Election
A recall election (also called a recall referendum or representative recall) is a procedure by which voters can remove an elected official from office through a direct vote before his or her term has ended. Recalls are initiated when sufficient voters sign a petition.
Runoff Election
An election that serves as a second round if no candidate attains a majority in the first round. Runoffs can exist for primary and, in rare cases, for general elections.
Special Election
An election held to fill a political office that has become vacant in between regularly scheduled elections.
Start Date
The date an election begins. Most elections begin and end on a single day.
State Officers
Executive-level statewide offices (in addition to governor). Some examples include Attorney General, Treasurer and Secretary of State, although office titles can vary by state. Usually elected on the same date as the governor.
State Legislative Reporting Level
Results tabulated by state legislative district for a state-wide or federal race. A state legislative district elects one or more members of the state legislature.
State Legislature
A state legislature is a generic term referring to the legislative body of any of the country's 50 states. The formal name varies from state to state. In 25 states, the legislature is simply called the Legislature, or the State Legislature, while in 19 states, the legislature is called the "General Assembly". In Massachusetts and New Hampshire, the legislature is called the General Court, while North Dakota and Oregon designate the legislature as the Legislative Assembly. Most states have two chambers, but Nebraska has just one.
Straight Party or Straight Ticket Votes
The number of ballots cast where every vote was for the same party. This is provided in some states' results files.
U.S. House
The United States House of Representatives is one of the two houses of the United States Congress (a bicameral legislature). It is frequently referred to as the House. The other chamber is the Senate.
U.S. Senate
The United States Senate is the upper house of the bicameral legislature of the United States, and together with the United States House of Representatives makes up the United States Congress.
Unofficial Election Results
Results that are not certified by an official election authority.
What's inside
Alphabetical glossary of 25 election terms with plain-English definitions.
Change this for your project
- Replace
OpenElectionsreferences with your project name if not using that project - Update
permalink: /glossary/to match your site's URL structure - Remove or add terms specific to your election data domain
Where it goes
Keep it in your repository where the agent or team that needs it will read it.
Worth borrowing
- Plain-language definitions for domain-specific terms
- Single-source glossary that can be linked from other docs
Related Documents
Glossary
Collects advanced deep learning terms not covered in introductory glossaries, with brief definitions and links to papers.
专有词汇翻译记录
Records Chinese translations of OpenGL and graphics programming terms for consistent use across a translation project.
Glossary
Defines retrieval, chunking, embedding, search, reranking, and synthesis terms with formulas, examples, and metric comparisons for RAG experiments.
Glossary for *Artificial Intelligence: A Modern Approach*
Lists and defines hundreds of AI terms from the textbook *Artificial Intelligence: A Modern Approach*, organized alphabetically with cross-references.