> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tightknit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Polls

> Create and manage community polls

Create quick and easy polls for your community members to engage in. Polls can be created and managed from Slack or from the Studio.

<Tabs>
  <Tab title="Slack">
    ## Creating a Poll

    In the chat or search bar, type the `/poll` command to get started.

    <Frame caption="Using the /poll slash command">
      <img src="https://mintcdn.com/tightknit/8RgBfwvyxlVVp-GI/assets/member-engagement/polls/polls-command.png?fit=max&auto=format&n=8RgBfwvyxlVVp-GI&q=85&s=73085ca7217b6ae8ad1c84b8d015797c" alt="Using the /poll slash command" width="1458" height="416" data-path="assets/member-engagement/polls/polls-command.png" />
    </Frame>

    <Frame caption="Poll creation modal">
      <img src="https://mintcdn.com/tightknit/8RgBfwvyxlVVp-GI/assets/member-engagement/polls/polls-example.png?fit=max&auto=format&n=8RgBfwvyxlVVp-GI&q=85&s=22502f8752aca9122d83c1b3ce0d905d" alt="Poll creation modal" width="1554" height="730" data-path="assets/member-engagement/polls/polls-example.png" />
    </Frame>

    In the Poll creation modal you can configure the following settings:

    * **Selected Channel** — The channel that the Poll will be posted in (only [activated channels](/channels-and-feeds/activate-channel) may be used).
    * **Poll Question** — The primary question or topic for the Poll that users will be voting on.
    * **Poll Choices** — The different options or choices that users will be able to vote on. Each option should be on a separate line. Max 25 options.
    * **Schedule** — Optionally schedule the poll to be posted at a future date and time instead of immediately. The scheduled time must be at least 1 minute in the future.
    * **Votes per user** — Determines how many times each user can vote in the poll
      * **Single vote** — Each user can only vote once. Voters can switch their single vote to another option, or click the same option again to remove their vote.
      * **Multiple votes** — Each user can vote for multiple options. Voters can remove their vote for a specific option by clicking the same option again.
    * **Voter Responses** — Determines if and how the names/identities of the voters are displayed.
      * **Public** — The names of the users that have voted are displayed publicly with the results.
      * **Anonymous** — The names are of the users are not displayed anywhere.
      * **Confidential** — The names of the users are only displayed to the poll creator.
    * **Poll Results** — Determines how the results of the poll (i.e. the vote count) are displayed. Note that the poll creator may privately view the poll results at all times, regardless of the setting.
      * **Real-time** — The poll results are displayed alongside the poll and updated in real-time.
      * **After poll closed** — The poll results are displayed publicly alongside the poll only when the poll is closed. The poll creator may privately view the poll results at all times. Voters are notified of a successful vote via a private ephemeral message.
      * **Not shown to participants** — The poll results are never shown publicly to participants. Only the poll creator may privately view the poll results. Voters are notified of a successful vote via a private ephemeral message.

    ## Polls List

    Access the Polls List from the **Polls** button in the Tightknit app settings in the Slack App Home.

    The list displays each poll's question, status, creator, channel, and voting configuration. You can filter polls by status using the dropdown at the top:

    * **All Active** — Shows all non-closed polls (open and scheduled). This is the default view.
    * **Open** — Shows only polls that are currently live and accepting votes.
    * **Scheduled** — Shows only polls scheduled to be posted at a future date and time.
    * **Closed** — Shows only polls that have been closed.

    From the Polls List, you can create a new poll using the **+ Create Poll** button, or use the overflow menu on any poll to:

    * **View Results** — View the current voting results.
    * **View in Channel** — Jump to the poll message in Slack.
    * **Edit** — Edit the poll question or reschedule a scheduled poll.
    * **Close Poll** — Close the poll so no more votes can be cast.
    * **Reopen Poll** — Reopen a previously closed poll.
    * **Delete** — Permanently delete the poll and its results.

    <Info>
      The Polls List in Slack is available to admins only.
    </Info>

    ## Managing Polls

    You can manage an individual poll in two ways from Slack:

    1. **From the Polls List** — Use the overflow menu on any poll in the Polls List.
    2. **From the message** — Use the [**Manage Content** message shortcut](/slack/shortcuts-and-commands/message-shortcuts#manage-content-shortcut) on a poll message in a channel.

    ### Edit Poll

    Once a poll has been created, only the Poll Question may be updated. For scheduled polls, you can also update the scheduled posting time.

    ### Close Poll

    Once a poll has been closed, no more votes may be cast. The option buttons will no longer be displayed. The poll results and responses may be displayed, depending on the **Poll Results** and **Voter Responses** settings.

    The poll creator may re-open a closed poll, for example, if they forgot to include someone's vote.

    <Info>
      Polls can only be closed manually. We do not support scheduled close dates at
      this time.
    </Info>

    ### Delete Poll

    The poll and the voting results will be permanently deleted. This action cannot be undone.

    ### View Results

    The results of a poll, i.e. the number of votes for each choice, can be viewed through the `•••` dropdown menu next to the poll, or from the Polls List.

    <Frame caption="Poll overflow menu with view results option">
      <img src="https://mintcdn.com/tightknit/8RgBfwvyxlVVp-GI/assets/member-engagement/polls/poll-menu.png?fit=max&auto=format&n=8RgBfwvyxlVVp-GI&q=85&s=384664eb1886e0a9738c439ae2022929" alt="Poll overflow menu with view results option" width="640" height="254" data-path="assets/member-engagement/polls/poll-menu.png" />
    </Frame>

    The behavior of this action depends on the current user and the configuration of the poll settings:

    1. The poll creator can always view the voting results of the poll at any time.
    2. For all other users, the results will be displayed appropriately based on the **Poll Results** setting.

    <Info>
      The names of voters are only visible in the results if the **Voter Responses**
      setting is set to *Public* (visible to all users) or *Confidential* (visible
      only to the poll creator).
    </Info>

    <Frame caption="What the user sees if they are not allowed to view results">
      <img src="https://mintcdn.com/tightknit/QRIuzh-lFpzgJ9Wi/assets/member-engagement/polls/insufficient-poll-permissions.png?fit=max&auto=format&n=QRIuzh-lFpzgJ9Wi&q=85&s=4b7f95952e79647597cdba41b4e3985d" alt="What the user sees if they are not allowed to view results" width="508" height="222" data-path="assets/member-engagement/polls/insufficient-poll-permissions.png" />
    </Frame>
  </Tab>

  <Tab title="Studio">
    ## Creating a Poll

    Navigate to the **Polls** page in the [Admin Studio](https://studio.tightknit.ai/-/polls) and click **Create Poll**. Configure the following:

    * **Channel** — The Slack channel the poll will be posted in (only [activated channels](/channels-and-feeds/activate-channel) may be used).
    * **Poll Question** — The question or topic for the poll (3 to 350 characters).
    * **Description** (optional) — Additional context for the poll (up to 1,000 characters).
    * **Poll Choices** — The options voters can choose from. You can add between 2 and 25 options (each up to 150 characters).
    * **Multiple Choice** — Toggle to allow voters to select more than one option. When off, voters can only select a single option.
    * **Results Visibility** — Controls when vote counts are shown:
      * **Real-time** — Results are visible alongside the poll and update as votes come in.
      * **After poll closed** — Results are shown publicly only after the poll is closed.
      * **Hidden** — Results are never shown publicly. Only the poll creator can view them.
    * **Voter Identity** — Controls whether voter names are visible:
      * **Public** — Voter names are shown to everyone.
      * **Confidential** — Voter names are only visible to the poll creator.
      * **Anonymous** — Voter names are not shown to anyone.
    * **Schedule** (optional) — Schedule the poll to be posted at a future date and time instead of immediately.

    <Info>
      Creating polls from the Studio requires the **Manage Polls** permission.
    </Info>

    ## Polls List

    Navigate to the **Polls** page in the [Admin Studio](https://studio.tightknit.ai/-/polls) to view all polls in a searchable, sortable table.

    The table displays each poll's status, question, channel, creator, vote count, number of options, results visibility, voter identity setting, and creation date. You can search polls by question and filter by status:

    * **All** — Shows all polls regardless of status.
    * **Open** — Shows only polls that are currently live and accepting votes.
    * **Scheduled** — Shows only polls scheduled to be posted at a future date and time.
    * **Closed** — Shows only polls that have been closed.

    Click any poll row to open its detail page.

    <Info>
      Viewing the Polls page requires the **View Community Data Pages** permission. Creating, editing, closing, reopening, and deleting polls requires the **Manage Polls** permission.
    </Info>

    ## Poll Detail Page

    Click any poll in the Studio Polls list to open its detail page. The detail page displays:

    * **Poll status**, vote count, question, and optional description
    * **Results breakdown** with a bar graph showing each option's vote count and percentage, along with inline voter avatars (when visible)
    * **Voter table** view that you can toggle to see individual votes with voter name, selected option, and vote date
    * **Metadata sidebar** with created/updated by, scheduled date (if applicable), close date, option count, voting type, and visibility settings

    From the detail page overflow menu, you can edit, close, reopen, or delete the poll.

    <Info>
      Voter identities are displayed based on the poll's **Voter Identity** setting. Anonymous polls never reveal voter names, even on the detail page.
    </Info>

    ## Managing Polls

    You can manage an individual poll from the Studio Polls list overflow menu or from the poll's detail page.

    ### Edit Poll

    Once a poll has been created, only the Poll Question and Description may be updated. For scheduled polls, you can also update the scheduled posting time.

    ### Close Poll

    Once a poll has been closed, no more votes may be cast. The option buttons will no longer be displayed in Slack. The poll results and responses may be displayed, depending on the **Results Visibility** and **Voter Identity** settings.

    The poll creator may re-open a closed poll, for example, if they forgot to include someone's vote.

    <Info>
      Polls can only be closed manually. We do not support scheduled close dates at
      this time.
    </Info>

    ### Delete Poll

    The poll and the voting results will be permanently deleted. This action cannot be undone.

    ### View Results

    Click any poll in the Polls list to open its detail page, where the full results, voter breakdown, and metadata are shown.

    The visibility of voter identities depends on the poll's **Voter Identity** setting. Anonymous polls never reveal voter names, even on the detail page.
  </Tab>
</Tabs>


## Related topics

- [MCP Server](/integrations/mcp.md)
- [Zoom Meeting Templates](/guides/zoom-meeting-template-guide.md)
- [Studio](/studio/overview.md)
- [Message Shortcuts](/slack/shortcuts-and-commands/message-shortcuts.md)
- [Slash Commands](/slack/shortcuts-and-commands/slash-commands.md)
