> For the complete documentation index, see [llms.txt](https://docs.voting.works/vxsuite-tdp-v4.1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voting.works/vxsuite-tdp-v4.1/system-overview/vxscan-polls-reports.md).

# VxScan Reports

## Polls Opened and Closed Reports

When polls open or close on VxScan, a tally report is printed. The tally report contains the tally results (pre-adjudication) of all ballots scanned at the scanner.

The tally report header contains the following information:

* **Title** - Includes the type of the polls report and the name of the polling place
* **Subtitle** - For primary elections, includes the full party name or "Nonpartisan Contests"
* **Election Info** - The title, date, and location of the election
* **Timestamps** - The first timestamp indicates when the poll status changed and the second indicates when the report was printed. In most cases these times are the same, but in some cases the report may be printed later.
* **Election ID** - The election ID on the report is a concatenation of the ballot hash and election hash and specifies exactly which election definition and election settings that the report corresponds to
* **Certification Signatures** - The space is provided for poll workers or election officials to sign the report in accordance with local statute.

For elections with multi-sheet ballots, counts per sheet are displayed in addition to the overall ballot count.

Each candidate or contest option appears in a row below the contest header. Because results at VxScan are not yet adjudicated, all write-ins are grouped under the "Write-In" bucket (except unmarked write-ins, which are reported as undervotes until adjudicated at VxAdmin).

As a rule, the sum of the number of votes for all candidates, the number of undervotes, and the number of overvotes will equal the number of total possible votes for the contest, which is the number of ballots times the number of selections allowed.

<pre><code><strong>candidate votes + undervotes + overvotes = ballots * votes allowed
</strong></code></pre>

<div><figure><img src="https://629495352-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ4bC0rbmogHEUUuMLAUa%2Fuploads%2FdmF8QUS4YPwLNdmtSmtb%2Fvoting-004-polls-opened-report.png?alt=media&amp;token=cb7ea996-5d48-4243-8b13-ee8e76168e48" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="https://629495352-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ4bC0rbmogHEUUuMLAUa%2Fuploads%2FeLJUmIfAWtdWdVIxHf0c%2Fvoting-023-polls-closed-report.png?alt=media&amp;token=1454397d-7f4b-47ad-b139-e1561d112f62" alt="" width="375"><figcaption></figcaption></figure></div>

If there were multiple batches, which on VxScan is a result of pausing and resuming voting, the polls closed report will contain a "Batch Summary" table with the sizes and timestamps of the batches.

## Voting Paused and Resumed Reports

When voting is paused, VxScan prints a voting paused report containing the total ballot count and ballot count of the most recent batch. When voting is resumed, VxScan prints a voting resumed report containing the total ballot count. The full batch history is included in the "Batch Summary" table.

Tally results are never included in polls paused or resumed reports.

<div><figure><img src="https://629495352-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ4bC0rbmogHEUUuMLAUa%2Fuploads%2FjpLNVSmDPDDxmT7tWdLL%2Fvoting-033-voting-resumed-report.png?alt=media&amp;token=dd3e232e-c4d3-4533-a7b9-9d24241a291f" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="https://629495352-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ4bC0rbmogHEUUuMLAUa%2Fuploads%2Fmfti1BmpvkZFWuCgP6BN%2Fvoting-037-voting-paused-report.png?alt=media&amp;token=e02be39e-053a-4840-959c-b51913493fdc" alt="" width="375"><figcaption></figcaption></figure></div>

## Write-In Image Reports

If `precinctScanEnableWriteInImageReport` is true in the system settings, poll workers will be able to print write-in image reports from the poll worker menu after polls are closed. For each contest that allows write-ins, the report lists the total number of write-ins and includes an image of each write-in.

<figure><img src="https://629495352-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ4bC0rbmogHEUUuMLAUa%2Fuploads%2FdS5SphuE8midzghuqQlz%2Fwrite-in-report-002-write-in-image-report.png?alt=media&amp;token=bca95dc4-58ff-4616-95f7-1f42e4fb3367" alt="" width="375"><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.voting.works/vxsuite-tdp-v4.1/system-overview/vxscan-polls-reports.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
