When AI answers voters, it should cite vetted reporting
Voter Guide Commons gives Claude, ChatGPT and other assistants your voter guide to quote word for word, with your newsroom's name and a link on every answer. Read the exact instructions we give the AI.
The terms
You opt in and keep ownership. Nothing is used until we both agree.
You can leave anytime. Tell us and we remove your guide.
We vet who joins. We include voter guides from news organizations that do original reporting, publish an ethics or corrections policy and are independent of campaigns and parties. Many members of journalism associations like the Institute for Nonprofit News and LION Publishers fit that description.
What you get
-
Credit on every answer
Your newsroom's name and a link to the candidate's page in your guide. See an example.
-
A card with your name and logo on it
Some assistants can show a card beside the written answer. A voter who gives an address sees the races your guide covers there. One who asks about a race sees who is running, and asking to compare puts the candidates' answers side by side. Every candidate and race on a card links to its page in your guide.
Your logo goes at the top of your cards. The signup form asks for a link to it. Already taking part? Email it to us.
-
A count of the readers we send
Every link to your site that we give the assistant carries
utm_source=voterguidecommonsandutm_medium=ai. In Google Analytics or any tool that reads those tags, filter on that source to see visits from assistant answers. An assistant that retypes a link can drop the tag, so treat the number as a minimum. -
A summary of what gets looked up
We email you a summary of how assistants used your guide. It has:
- how many times assistants drew on your guide, and which assistants
- the candidates and races looked up most
- the topics searched, in the assistant's search words
- what was looked for and isn't in your guide, such as an office you don't cover
- how many times a voter's address in your state was looked up to find their races
These count lookups, not people. An assistant often makes several lookups to answer one question, and we see those lookups, not the question someone typed. We never keep an address, only the state it's in.
Want the numbers for a particular stretch, like the weeks before the election? Ask and we'll send them.
-
A line asking readers to support you
If you're a nonprofit that takes donations, we ask the assistant to end answers that quote your guide with a line inviting readers to support your work, linked to your donation page. That link carries the same tag. Tell us if your donation page moves or you'd rather we left the line off.
-
Word when an answer gets your guide wrong
Anyone can report an answer that misquotes your guide, credits the wrong newsroom, leaves out a candidate or says something your guide doesn't. A person at Hacks/Hackers reads every report.
Once your guide is in
Already taking part: Wisconsin Watch, Planet Detroit, Grady Newsource, CalMatters, Palo Alto Online, The Almanac, Mountain View Voice, Redwood City Pulse, Civil Beat, Press Herald, Sahan Journal, WBOC, Eden Prairie Local News and CT Mirror.
-
See it yourself
Ask about races your guide covers at voterguidecommons.org/ask, no setup, and compare the answers with your guide. To see it in your own assistant, add Voter Guide Commons with these steps.
To see it working before you install anything, watch the recording of our October 14 demo.
-
When your guide changes
We read some guides straight from the newsroom's own data and refresh others by hand. Either way, email us when you add races or a candidate drops out, and we'll make sure answers catch up.
Put the question box on your site
Readers who don't use Claude, ChatGPT or Gemini can ask the guides in a box on our site, voterguidecommons.org/ask. Each newsroom taking part can put its own box on its pages, in its colors, answering only from its own guide. It answers the way the connector does: it quotes the guide, names the newsroom and links to each candidate's page.
-
Getting it on your page
Email contact@voterguidecommons.org. We send a preview of your box and a link to a form where you set your Anthropic key. Once the key is set, the form gives you one line of code, and the box loads on your site and nowhere else.
-
Who pays for the answers
Your box answers on your own Anthropic account, so your readers' questions are billed to you. You set a monthly spend limit on the key in the Claude Console, and a limit on questions a day with us. In our tests a question cost about a tenth of a cent, so 1,000 questions is about $1 to $3. Please don't send a key by email: the form checks it, stores it encrypted and never shows it again.
-
What you'll see
We count the questions asked on your page, and the candidates and races they looked up, and can share those numbers with you. We don't keep what readers type.
Add your newsroom's guide
Someone at Hacks/Hackers reads every signup, checks it against the bar above and follows up by email. Questions first? Email contact@voterguidecommons.org.

