> For the complete documentation index, see [llms.txt](https://docs.voting.works/vxsuite-tdp-v4/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/readme/vxadmin-results-exports/tally-reports.md).

# Tally Reports

## Basic Structure

The basic structure of the tally reports printed from VxAdmin is similar to the [polls opened and closed reports](/vxsuite-tdp-v4/readme/vxscan-polls-reports.md) printed from VxScan.

<figure><img src="https://2844856024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1u8fW6N860E8KpEACPsc%2Fuploads%2Fgit-blob-be048d68441ff7c716c7aa529f68943cdc42f37b%2Fadmin-full-election-report%202.png?alt=media" alt="" width="375"><figcaption><p>Full election tally report</p></figcaption></figure>

## Filtered and Grouped Reports

In addition to the full election report, VxAdmin exports reports filtered or grouped by the following dimensions:

* Ballot Style
* Precinct
* Voting Method
* Scanner
* Batch
* District (filtering only)

When a report is grouped, the report is broken up into multiple sections each with their own filter. For example, if you were to group by "Voting Method," the resulting report would have a section filtered for precinct ballots only and a section filtered for absentee ballots only:

<div><figure><img src="https://2844856024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1u8fW6N860E8KpEACPsc%2Fuploads%2Fgit-blob-35ada84c14f32b886d9e75e789fd49f554ebda2d%2Ftally-report-grouped-1.png?alt=media" alt="" width="375"><figcaption><p>First part of a grouped tally report</p></figcaption></figure> <figure><img src="https://2844856024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1u8fW6N860E8KpEACPsc%2Fuploads%2Fgit-blob-98cf8a464d30d7f498a2ccc1efdad703b35390a4%2Ftally-report-grouped-2.png?alt=media" alt="" width="375"><figcaption><p>Second part of a grouped tally report</p></figcaption></figure></div>

The filter for a given report section is indicated in the title of the report. If the report has more than one filter applied to it, the full details of the filter will be specified in a box below the title:

<figure><img src="https://2844856024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1u8fW6N860E8KpEACPsc%2Fuploads%2Fgit-blob-82b16c883eb8ed79b808d485ea94177b6c157cf7%2Ftally-report-complex-filter-1.png?alt=media" alt="" width="375"><figcaption><p>Tally report with a complex filter</p></figcaption></figure>

Note that filters and groups can be combined.

## Manual Results

If manual results have been added, they will be included in the tally report alongside the scanned results. For each contest, there will be three results columns: "scanned", "manual", and "total".

<figure><img src="https://2844856024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1u8fW6N860E8KpEACPsc%2Fuploads%2Fgit-blob-c9fb5c5d73a636addf6e42c762578ef04e93ab3d%2Ftally-report-manual-1.png?alt=media" alt="" width="375"><figcaption><p>Tally report with manual results</p></figcaption></figure>

## Write-In Candidate Aggregation

In order to prevent a long list of write-in candidates from making contest results difficult to read, VxAdmin tally reports consolidate write-in candidates if they're not relevant to the contest outcome. Relevant write-ins are included as "\<Name> (Write-In)". Irrelevant write-ins are consolidated as "Write-In" or, if there are relevant write-ins in the list, "Other Write-In". Unadjudicated write-ins are always consolidated as "Unadjudicated Write-In." A write-in is deemed relevant if it has won.

<div><figure><img src="https://2844856024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1u8fW6N860E8KpEACPsc%2Fuploads%2Fgit-blob-ec26fbc20ae8a73f6a3755924badee933a863d02%2FScreen%20Shot%202024-10-01%20at%204.52.26%20PM.png?alt=media" alt="" width="407"><figcaption><p>Before adjudication</p></figcaption></figure> <figure><img src="https://2844856024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1u8fW6N860E8KpEACPsc%2Fuploads%2Fgit-blob-db64d6d2be4916341fa3db3a99eb97300349e718%2FScreen%20Shot%202024-10-01%20at%204.52.31%20PM.png?alt=media" alt="" width="392"><figcaption><p>Adjudication just started</p></figcaption></figure> <figure><img src="https://2844856024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1u8fW6N860E8KpEACPsc%2Fuploads%2Fgit-blob-8e619acdad79c5f4e35fab45cbb383a579e0b397%2Fwrite-ins-edited.png?alt=media" alt="" width="399"><figcaption><p>Adjudication almost finished</p></figcaption></figure></div>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.voting.works/vxsuite-tdp-v4/readme/vxadmin-results-exports/tally-reports.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
