> For the complete documentation index, see [llms.txt](https://docs.linuxfoundation.org/lfx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.linuxfoundation.org/lfx/project-control-center/v2-latest-version/collaborations/voting-feature/creating-a-vote.md).

# Creating a Vote

Create a vote to gather input from committee members on project decisions. The Create Vote form adapts based on the voting type you select, showing additional fields specific to each method.

For help choosing a voting type, see [Voting Feature](/lfx/project-control-center/v2-latest-version/collaborations/voting-feature.md).

## Open the Create Vote Form

1. Log in to PCC.
2. From the Project dashboard, click **Collaboration > Voting**.
3. Click **Create New Vote**. The Create New Vote dialog opens.

## Common Fields

These fields appear for all voting types.

| Field                | Description                                                                                                                                                                                                     |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | A brief, descriptive title for the vote (e.g., "Community Feedback on New Feature" or "Quarterly Project Review").                                                                                              |
| **Voting Type**      | Select the voting method. Options: **Plurality**, **Majority**, **Condorcet IRV**, **Instant Runoff**, **Meek STV**. The form updates to show additional fields based on your selection.                        |
| **Close Date**       | The voting deadline. After this date, no more votes are accepted and results are finalized. The close date is set to **11:59 PM Pacific Time** on the selected date and must be at least one day in the future. |
| **Committee**        | The committee whose members are eligible to vote. Only committees with voting enabled are shown. If only one committee is available, it is automatically selected.                                              |
| **Voting Status**    | Filter which committee members can vote based on their role. Options: **Voting Rep** (selected by default), **Alternate Voting Rep**, **Observer**, **Emeritus**. You must select at least one status.          |
| **Pseudo-Anonymity** | When enabled, individual voter responses are hidden in the results UI. Vote totals are still visible.                                                                                                           |
| **Allow Abstain**    | When enabled, voters can formally abstain from the vote. Available for Plurality, Majority, Condorcet IRV, Instant Runoff and Meek STV.                                                                         |
| **Description**      | Background information and instructions for voters. Supports rich text formatting including bold, italic, underline, strikethrough, bulleted and numbered lists, block quotes, links, and images.               |

After you select a committee and voting status, the form displays the number of **eligible members** who match your criteria. If no members are eligible, a warning appears.

{% hint style="info" %}
For Condorcet IRV and Meek STV, at least **3 eligible members** are required.
{% endhint %}

## Additional Fields by Voting Type

### Majority Voting

When you select **Majority** as the voting type, two additional fields appear:

| Field                 | Description                                                                                                                                                    |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Quorum**            | The minimum percentage of eligible voters who must participate for the vote to be valid. Options: **None**, **25%**, **50%**, **75%**, or **Custom** (1–100%). |
| **Winning Threshold** | The percentage of votes a choice must receive to win. Options: **None (Plurality)**, **50%**, **75%**, or **Custom** (1–100%).                                 |

### Meek STV

When you select **Meek STV** as the voting type, one additional field appears:

| Field                 | Description                                                                                                                                                    |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Number of Winners** | The number of choices to be elected. Minimum of **2**. Must be fewer than the number of eligible members and fewer than the number of options in any question. |

## Adding Questions and Options

Each vote starts with one question and two empty options by default.

* Click **+ Add Question** to add another question (up to **50 questions** per vote).
* Click **+ Add Option** to add more answer choices to a question. Each question requires at least **2 options**.
* Each question has a **500-character limit**.
* Duplicate options within the same question are not allowed.

{% hint style="info" %}
To remove a question, click the delete icon next to it. You must always have at least one question.
{% endhint %}

### Question Type by Voting Method

The question type determines how voters interact with the options:

| Voting Type                                         | Question Type             | Voter Experience                                                                                                                    |
| --------------------------------------------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Plurality**                                       | Single or Multiple Choice | You choose the question type per question. Single choice: voters pick one option. Multiple choice: voters pick one or more options. |
| **Majority**                                        | Single Choice             | Voters pick one option per question.                                                                                                |
| **Condorcet IRV**, **Instant Runoff**, **Meek STV** | Ranked                    | Voters rank all options in order of preference.                                                                                     |

## Save the Vote

When you have completed the form, click **Save**.

* The vote is created as a **Draft** and is not yet visible to voters.
* If there are no eligible members matching your committee and voting status selection, a confirmation dialog asks whether you want to proceed.

{% hint style="warning" %}
A newly created vote is saved as a draft. To activate the vote and notify committee members, you must **enable** it from the Voting dashboard. See [Managing a Vote](/lfx/project-control-center/v2-latest-version/collaborations/voting-feature/managing-a-vote.md) for instructions.
{% endhint %}

{% hint style="success" %}
**Tips:**

* The close date is always set to **11:59 PM Pacific Time**, regardless of your local timezone.
* You can clone an existing vote to reuse its settings. The cloned vote name defaults to "Copy Of \[original name]".
* After creating a vote, you can edit it while it is still in draft status. Once enabled, the voting type cannot be changed.
  {% endhint %}


---

# 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.linuxfoundation.org/lfx/project-control-center/v2-latest-version/collaborations/voting-feature/creating-a-vote.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.
