For newsrooms

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 card headed with Planet Detroit's logo, titled What Planet Detroit's guide covers on your ballot. A note says the guide asks only about environmental policy. It lists twelve races for a Detroit address, then what the guide leaves out and links to the state's own voter information.
    A voter's ballot, from Planet Detroit's guide.
    A card headed with Wisconsin Watch's logo, titled Governor. Two columns show Tom Tiffany's and David Crowley's answers to the same question, with a menu to move between the guide's seven questions.
    Two candidates' answers to the same question, from Wisconsin Watch's guide.
  • A count of the readers we send

    Every link to your site that we give the assistant carries utm_source=voterguidecommons and utm_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.

Your outlet
Your home page, starting with https://
It goes at the top of your cards. A PNG or SVG file. If you have a version for dark backgrounds, add its link under "Anything else?"
Your voter guide
Which state or states, and which races. For example: governor and state legislature.
You
An address at your outlet's domain helps us confirm the signup.
If you're a nonprofit. Nine digits, like 12-3456789.

A person at Hacks/Hackers reviews every signup. Nothing goes live until both sides agree, and you can withdraw anytime.