# 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


---

# Agent Instructions: 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:

```
GET https://guides.mangoapps.com/user-guide/ballots/ballot-tools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.