# Create a Ballot

### Overview

The Ballots module in MangoApps provides a tailored, transparent, and configurable way to make group decisions or hold formal votes. Whether you are managing policy approvals or running elections, you have full control over who can vote, view results, comment, and modify settings — ensuring a secure and fair process from start to finish.

***

### Creating a Ballot

To create a new ballot, navigate to the **Ballots** module (on your navigation bar or within a team workspace where the module is enabled) and click **New Ballot**.

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

Select the **Team** that the ballot will be shared with and enter a **Title** and **Details**.

Next, choose what is on the ballot:

* **Document**: For specification, procedure, or process approvals. You will be required to attach supporting documentation if this selection is chosen.
* **Person**: For electing team representatives or board members. Select a user from the provided lookahead field.&#x20;

And the **Ballot Type**

* **Single Choice (Yes/No style)**: Select this type when you want to add only one ballot item below. This will give voters 'Yes/No/Abstain' actions against the ballot item.
* **Multiple Choice (Election style)**: Select this type when you want to add multiple choices for the ballot item below. This will give voters option to select from one of the choices and cast their vote.

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

***

### Configure **Voting Options**

Along the right hand side you will see additional options to configure the ballot:

* **Voting Days:** The desired voting period (open/close dates)
* **Who can view results:**
  * All members: All the members of the team can view the results irrespective of whether they are voters or not
  * Voters only: Only voters of this ballot can view results.
  * Admins only: Only the domain & team admins can view the results irrespective of whether they are voters or not

{% hint style="success" %}
The **ballot creator, domain, & team admins** will be able to view the results irrespective of this setting.
{% endhint %}

* **Result Availability:**&#x20;
  * When ballot opens (real time):
    &#x20;Results will be visible & upto date at all times after the ballot opens. The results will be visible to users based on 'Who Can View Results?' setting.
  * After ballot closes: Results will be visible only after the ballot close date (even to ballot creator & admins). The results will be visible to users based on 'Who Can View Results?' setting.

{% hint style="success" %}
The **ballot creator, domain & team admins** will also see the results based on this setting and not sooner.
{% endhint %}

* **Result Style:**&#x20;
  * Detailed: Full detailed results will be available online & for export. The detailed results will be available to users based on 'Who Can View Results?' setting.
  * Summary: Only summary of the results will be available online & for export. The summary results will be available to users based on 'Who Can View Results?' setting.

{% hint style="success" %}
The **ballot creator, domain & team admins** will get the detailed results view irrespective of this setting.
{% endhint %}

* **Advanced Settings**
  * Allow revoting
  * Set **Commenting Options**:
    * Who can comment: Anyone, Voters only, Admins only. The **ballot creator, domain & team admins** will be able to post a comment irrespective of this setting.
    * Who can view comments: Anyone, Voters only, Admins only. The **ballot creator, domain & team admins** will be able to view all the comments irrespective of this setting.

Once these settings have been configured, click **Save and Publish** or save a draft and return at a later date.


---

# 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/create-a-ballot.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.