Getting Started with Petition Checker

On this page

  1. What is Petition Checker?
  2. User roles & what you can do
  3. Step 1 — The Dashboard
  4. Step 2 — Uploading a petition
  5. Step 3 — OCR Review (optional)
  6. Step 4 — Match Review
  7. Step 5 — Cleanup
  8. Tips & common questions

What is Petition Checker?

Petition Checker helps campaigns verify that petition signatures are valid registered voters. When a petition is collected, each signer's name and address need to be checked against the official voter registration database. Doing this by hand is slow and error-prone — Petition Checker automates most of it.

Here's the basic flow of using this tool

  1. 1 You upload a scanned PDF of a petition.
  2. 2 The system reads the handwriting and extracts each row of signature data automatically.
  3. 3 A user confirms that the system has correctly read the pdf and makes manual correction as needed.
  4. 4 The tool searches the voter file to find the best matching registered voters for each signature.
  5. 5 You review the suggested matches and confirm, reject, or flag each one.
  6. 5 The user handles duplicates and keeps track of everything that was struck such as no matches or out of district voters.

User roles & what you can do

Every account has a role for each campaign. Your role determines which actions you can take. You can see your role on the campaign card on the dashboard.

User Limited Access

You can see the dashboard, Review OCR(optical character recognition), match review, and cleanup pages — but you cannot upload petition pdfs or voterfiles. Useful for volunteers to help with reviewing petitions.

Trusted User Standard working role

This role has all the same permissions as a regular user. They can also make uploads. This is the role most staff and trusted volunteers will have.

Admin Full control

Everything the Trusted User can do. Additionally, can delete uploads and make voterfile uploads.


The Workflow

1

The Dashboard

After signing in, you land on the dashboard. You'll see a card for each campaign you have access to. Each card shows:

Status badges explained:
Pending — file received, waiting to start.
Splitting — breaking the PDF into individual pages.
OCR Processing — reading the handwriting on each page.
OCR Complete — ready for your review.
Failed — something went wrong; contact your admin.
2

Uploading a Petition (Trusted Users & Admin)

Click Upload on a campaign card to submit a new batch of petition pages.

Before you upload

Make sure your petition PDF is a clean scan — the clearer the scan, the more accurately the system can read the handwriting. Multi-page PDFs are fine; each page will be processed separately.

Defining columns

Before uploading, you tell the system what columns are on your petition form (e.g., "Printed Name", "Street Address", "City", "Zip Code"). For each column, you specify:

If your petition already has a value printed in a column (for example, the county is pre-printed as "Cook"), you can enter it as a hardcoded value and the system will fill it in automatically for every row.

After you upload

The system works in the background to split your PDF and read the handwriting. This usually takes a few minutes depending on the number of pages. You can watch the status update on the dashboard — when it says OCR Complete, the pages are ready to review.

3

OCR Review

"OCR" stands for Optical Character Recognition — it's the technology that reads handwriting and turns it into text. It's very good, but not perfect. This step lets you catch and fix any mistakes before the system tries to find voter matches.

How it works

Click OCR Review from the dashboard. You'll see a queue of pages waiting for review. Click into a page and you'll get a split-screen view:

Compare the extracted text on the right with the handwriting on the left. If something was misread, click the cell and type the correction.

Confirming a page

When you're satisfied the extracted data looks correct, click Confirm Page. This locks in the corrections and kicks off voter matching for that page. You can then move on to the next page in the queue.

4

Match Review

This is the main working step. The system has already tried to find a matching registered voter for each signature. Your job is to confirm whether the suggestion is correct.

Click Match Review from the dashboard. You'll see a queue of pages with unreviewed rows. Click into a page to start reviewing.

The review screen

You'll see three panels:

Match scores

Each candidate has a score that reflects how closely they match the extracted name and address. The score goes from 0 to 1:

Green (high score) — Very likely the right person. Usually safe to confirm.
Yellow (medium score) — Possible match. Check the address or spelling carefully before confirming.
Red (low score) — Weak match. Likely not the right person.

Your three choices for each row

Select a match — Click on the candidate voter you believe is correct. The row is marked as matched and you move on to the next one.
No Match — Use this when no candidate looks right, or the person isn't in the voter file. The signature will be marked as invalid.
Illegible — Use this when you can't read the signature well enough to make a judgment. The row is flagged and set aside.

Completing a page

Once every row on a page has been reviewed, click Complete. The system will automatically take you to the next page in the queue. Keep going until the queue is empty.

5

Cleanup

After Match Review is done, the Cleanup page helps you tidy up two remaining categories: struck rows and duplicate signatures.

Struck Lines tab

This tab lists every row that was marked as No Match, Illegible, Out of District, or identified as a duplicate. For each row you can:

Duplicates tab

Sometimes the same registered voter appears on multiple petition sheets. This tab groups those rows together so you can decide what to do:

When duplicates are resolved and all struck rows are reviewed, your petition data is final and ready for reporting.

Tips & common questions

How long does OCR processing take?

Usually a few minutes for a typical batch. A large petition with hundreds of pages may take 10–15 minutes. You don't need to stay on the page — come back when the status shows OCR Complete.

What if I select the wrong match?

If you haven't completed the page yet, you can click a different candidate to change your selection. If you've already completed the page and moved on, go to the Cleanup page, find the row, click Restore, and it will appear again in Match Review.

When should I use "Illegible" vs "No Match"?

Use Illegible when you genuinely can't read what was written — the handwriting is too messy or the scan is too blurry to make out. Use No Match when you can read the name and address but no voter in the database matches them.

The voter file shows a slightly different address than what was written. Is that okay?

Yes — voters often abbreviate or write addresses informally. "123 Main St" and "123 Main Street" are the same address. Use your judgment: if the name and street number match, it's almost certainly the same person. If the street name is completely different, be more cautious.

What does "out of district" mean?

Some petitions can only count signatures from voters who live in a specific district. If the system flags a match as "out of district," the voter is in the database but does not live in the required area. Mark that row as No Match.

Can multiple people work on the same campaign at the same time?

Yes — the system is designed for teams. Different users can review different pages simultaneously. Each page is only assigned to one reviewer at a time to avoid conflicting edits.

I don't see the Upload button. Why?

Upload is only available to Editors and Admins. If you have a Viewer role, you won't see it. Contact your campaign admin if you need upload access.