The polls feature provides an easier way to gather feedback from members in a channel. To post a poll in a channel, you must send a message that contains the poll you created. Polls can only be sent with text messages in certain group channels. See the limitations section below to learn more about which type of channels and messages support polls.
The following are some of the ways that polls can be customized.
- Allow users to vote for a single option or multiple options.
- Allow users other than the creator of the poll to add new options.
- Display a partial list of voters for each option.
datawhich can contain additional information such as a supplementary explanation for each poll option in a key-value pair.
To use polls in your Sendbird application, you must activate the feature on Sendbird Dashboard. Go to Settings > Chat > Features and turn on the Polls feature.
Refer to the following limitations when using polls.
The maximum number of options that can be added to a poll differs depending on your Sendbird plan. For further information, contact our sales team.
Polls can't be sent in the following message types: file messages, admin messages, and scheduled text messages.
Polls information isn't included in the export result of the message data containing polls.
The table below shows the types of channels that support polls. See the channel types section to learn about the differences among various channel types.
|Open channel||Group channel||Supergroup channel|
Supported, except ephemeral channels
List of properties in a poll
The unique ID of a poll.
The text of a poll's title.
array of objects
An array of options that a user can vote for.
The number of voters who casted a vote on a poll.
The unique ID of the user who created a poll.
The status of a poll. The value can be
Indicates whether to allow users other than the creator of the poll to add new options to the poll.
Indicates whether to allow users to vote for multiple options.
The time when a poll is created in Unix seconds.
The time when a poll is updated in Unix seconds.
The time when a poll was closed or will be closed in Unix seconds. If the value of this property is
A JSON object of one or more key-value items to store additional information related to a poll.
List of properties in a poll option
The unique ID of a poll that a poll option belongs to.
The unique ID of a poll option. This value is unique within a poll.
The text that describes a poll option.
The number of votes casted on a poll option.
The unique ID of the user who created a poll option.
The time when a poll option is created in Unix seconds.
The time when a poll option is updated in Unix seconds.
array of objects
An array of users who voted for this poll option. Up to ten users can be shown.
The following table shows a list of actions supported for polls. API endpoints are relative to the base URL allocated to your Sendbird application. In this page, the base URL for the following endpoints is
Note: If you want to know the ID and base URL of your application, sign in to Sendbird Dashboard, go to Settings > Application > General, and check the Application ID and API request URL.
List of actions