> For the complete documentation index, see [llms.txt](https://guides.mangoapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.mangoapps.com/user-guide/ballots/ballot-tools.md).

# Ballot Tools

### Overview

The **Ballots** module in MangoApps makes it simple to conduct team-wide or organization-wide voting on topics such as leadership elections, process approvals, or decision-making tasks. Whether you're voting on people or documents, you can set voting periods, upload materials, and manage ballots with ease.

<figure><img src="/files/HRjha2jZBGpucMsa2RRT" alt="" width="563"><figcaption></figcaption></figure>

***

### Viewing Ballots

The ballot table gives you a snapshot of ballot activity and direct access to key functions, making it easy to monitor and manage organizational decisions.

#### On the Ballots screen, you will see:

* **Title** – The name of the ballot.
* **Item** – Indicates whether the ballot is for a **Person** (election) or a **Document** (approval).
* **Opening Date** and **Closing Date** – The timeframe during which voting is open.
* **Status** – Displays whether the ballot is:
  * `Not Yet Open`
  * `Open`
  * `Closed`
* **Views** – The number of times the ballot has been accessed.
* **Comment Count** – Shows the number of comments submitted (visible below the title).

You can also **filter** ballots using the dropdown menus at the top right:

* **View**: All, Open Ballots Only, Closed Ballots Only, Approved Ballots Only
* **Published**: All Time, Last 1 Year, Last 6 Months, Last 3 Months, This Month, This Week

***

### Ballot Actions Menu (3-dot menu)

Click the **3-dot icon** to the right of a ballot to access additional tools (if you have the necessary admin or creator permissions). Once a ballot is created, you can access management tools via the **three-dot menu** next to each ballot:

* **Edit Ballot:** Available only if the ballot is still open.
* **View Ballot History:** See a full audit trail of changes. Not available for closed ballots.
* **Change Voter List:** Modify eligible voters. Only available while the ballot is open. Choose to allow all team members or select specific individuals.
* **View Ballot Results:** See voting outcomes, subject to your configured visibility rules.
* **Export Results:** Download results as an Excel file.
* <mark style="color:red;">**Delete Ballot:**</mark> <mark style="color:red;"></mark><mark style="color:red;">Only the ballot creator or an admin can delete a ballot.</mark>
* **Reopen Ballot:** If a ballot has closed, the creator or an admin can reopen it. Reopening ballots is **not** recommended for election-style votin&#x67;*.*

***

### Voting on a Ballot

If you are part of a team that has been included in a ballot:

1. The ballot will appear on your **News Feed**.
2. Click **View Ballot**.
3. Choose your vote option.
4. Optionally, add a comment.
5. Click **Submit** to cast your vote.

<figure><img src="/files/sEMnGaYUf8gaoVGPLwv5" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Ballots are **not anonymous**. Voter names and choices are visible based on the result settings. This promotes transparency in the process.
{% endhint %}

***

### Viewing Ballot Results

Results can be accessed by clicking on the **three-dot menu** and selecting **View Ballot Results** or by accessing the **Ballot Tools** dropdown menu upon clicking on a ballot.&#x20;

<figure><img src="/files/uJWoLzWNwM3EcyZ7bPH1" alt=""><figcaption></figcaption></figure>

Based on the user's permission level:

* **Detailed results** will show how each person voted.
* **Summary results** will provide only vote totals.

Visibility of results can be limited to:

* All members
* Voters only
* Admins only