Map › About

How Ballot Atlas works

A free, nonpartisan guide to what's on your ballot, kept current by a research agent that runs every day.

Where the information comes from

Ballots come from each state's official candidate list where it can be found, then from Ballotpedia and established news outlets' voter guides. A race that couldn't be confirmed against an official list carries a note asking you to check your sample ballot.

Candidate profiles are researched by an AI agent (Anthropic's Claude) that searches the web, reads candidates' own websites and questionnaire answers, official records and news coverage. Every stance must cite a page the agent actually opened during that research. Anything it can't source is left out.

How we keep it neutral

• Stances are written in the candidate's own framing ("Supports…", "Opposes…"), never inferred from party.
• Judging words such as "radical", "extreme" or "common-sense" are blocked; a profile containing them is held for a person to review.
• Candidates are listed alphabetically, and parties are shown as text, not colors.
• Candidates in the same race are asked about the same topics so they can be compared.
• No campaign, party or PAC pays for anything on this site.

How often it updates

The research agent runs every morning. Each profile is refreshed at least weekly, and news older than 45 days drops off.

Report an error

If something is wrong or out of date, open an issue at github.com/Zaied-bayati/ballot-atlas/issues with the page link and a source for the correction.

Before you vote

Always confirm your registration, polling place and ballot with your state or county election office, or at vote.gov.