--- title: Polls description: Create, vote on, and manage polls in RealtimeKit meetings using the Core SDK. image: https://edgetunnel-b2h.pages.dev/dev-products-preview.png --- > Documentation Index > Fetch the complete documentation index at: https://edgetunnel-b2h.pages.dev/realtime/llms.txt > Use this file to discover all available pages before exploring further. [Skip to content](#%5Ftop) # Polls This guide explains how to create, vote on, and interact with polls in a meeting using Cloudflare RealtimeKit. WebMobile ReactWeb ComponentsAngular ## Introduction The meetings polls object can be accessed using `meeting.polls`. It provides methods to create polls, vote, and more. **JavaScript** ```js console.log("Polls object:", meeting.polls); ``` The `meeting.polls.items` property returns an array of all polls created in a meeting, where each element is an object of type `Poll`. **JavaScript** ```js console.log("All polls:", meeting.polls.items); ``` The meetings polls object can be accessed using `meeting.polls`. It provides methods to create polls, vote, and more. ```jsx console.log("Polls object:", meeting.polls); ``` The `meeting.polls.items` property returns an array of all polls created in a meeting, where each element is an object of type `Poll`. ```jsx console.log("All polls:", meeting.polls.items); ``` You can access the polls functionality in a meeting using the `meeting.polls` object. This object provides methods to create polls, vote, and perform other poll-related actions. To retrieve all polls created during a meeting, use `meeting.polls.items`. This returns an array where each element is an object of type `com.cloudflare.realtimekit.polls.Poll`. The meetings polls object can be accessed using `meeting.polls`. It provides methods to create polls, vote, and more. `meeting.polls.items` returns an array of all polls created in a meeting, where each element is an object of type `Poll`. The meetings polls object can be accessed using `meeting.polls`. It provides methods to create polls, vote, and more. `meeting.polls.items` returns an array of all polls created in a meeting, where each element is an object of type `Poll`. The meetings polls object can be accessed using `meeting.polls`. It provides methods to create polls, vote, and more. `meeting.polls.items` returns an array of all polls created in a meeting, where each element is an object of type `Poll`. ### Poll Type The `Poll` type is defined as follows: **TypeScript** ```typescript interface Poll { id: string; question: string; options: PollOption[]; anonymous: boolean; hideVotes: boolean; createdBy: string; createdByUserId: string; voted: string[]; // stores participant ID } interface PollOption { text: string; votes: { id: string; // stores participant ID name: string; }[]; count: number; } ``` The `Poll` type is defined as follows: **TypeScript** ```typescript interface Poll { id: string; question: string; options: PollOption[]; anonymous: boolean; hideVotes: boolean; createdBy: string; createdByUserId: string; voted: string[]; // stores participant ID } interface PollOption { text: string; votes: { id: string; // stores participant ID name: string; }[]; count: number; } ``` The `Poll` type represents a poll within a meeting: **Kotlin** ```kotlin class Poll( val id: String, val question: String, val anonymous: Boolean, val hideVotes: Boolean, val createdBy: String, val options: List, val voted: List, ) ``` Each poll contains a list of `PollOption` objects, representing the available options for that poll. Every `PollOption` includes a list of `PollVote` objects, where each vote contains the voter's `id` and `name`. **Kotlin** ```kotlin class PollOption( val text: String, val votes: List, val count: Int ) ``` **Kotlin** ```kotlin class PollVote( val id: String, val name: String ) ``` The `Poll` type is defined as follows: **Swift** ```swift class Poll { let id: String let question: String let anonymous: Bool let hideVotes: Bool let createdBy: String let options: [PollOption] let voted: [String] } ``` The type `Poll` is the main class for any poll in RealtimeKit. It also contains list of `PollOption` which are options for a given poll. And every `PollOption` has list of votes inside of it. Votes are objects of class `PollVote` which internally has id and name of the vote. **Swift** ```swift class PollOption { let text: String let votes: [PollVote] let count: Int } class PollVote { let id: String let name: String } ``` The `Poll` type is defined as follows: **Dart** ```dart class Poll { final String id; final String question; final bool anonymous; final bool hideVotes; final String createdBy; final List options; final List voted; } ``` The `Poll` class has the following properties: * `id`: Unique ID assigned to each poll. * `question`: Question of the poll. * `anonymous`: To hide the votes of each user even after completion. (false by default) * `hideVotes`: Hide votes until the voting is complete. (enabled if anonymous is enabled) * `createdBy`: Name of creator the poll. * `options`: Array of `PollOption` object, contains all the options to the poll question. * `voted`: Array of String which contains User IDs that have voted. The type `Poll` represents a poll in a RealtimeKit meeting. It also contains list of `PollOption` which are options for a given poll. And every `PollOption` has list of votes inside of it. Votes are objects of class `PollVote` which internally has id and name of the vote. **Dart** ```dart class PollOption( final String text; // Option text. final List votes; // List of votes. final int count; // Number of votes. ); class PollVote { final String id; // ID of the voter. final String name; // Name of the voter. } ``` The `Poll` type is defined as follows: **TypeScript** ```ts interface Poll { id: string; question: string; options: PollOption[]; anonymous: boolean; hideVotes: boolean; createdBy: string; createdByUserId: string; voted: string[]; // stores participant ID } interface PollOption { text: string; votes: { id: string; // stores participant ID name: string; }[]; count: number; } ``` ## Creating a Poll A new poll can be created using the `create` method from the `meeting.polls` object. The `meeting.polls.create()` method accepts the following parameters: * `question` (string) - The poll question * `options` (string\[\]) - Array of poll options * `anonymous` (boolean) - Whether votes are anonymous * `hideVotes` (boolean, optional) - Whether to hide vote counts The following snippet creates a poll where votes are anonymous: **JavaScript** ```js await meeting.polls.create( "Are you an early bird or a night owl?", ["Early bird", "Night owl"], true, ); ``` A new poll can be created using the `create` method from the `meeting.polls` object. The `meeting.polls.create()` method accepts the following parameters: * `question` (string) - The poll question * `options` (string\[\]) - Array of poll options * `anonymous` (boolean) - Whether votes are anonymous * `hideVotes` (boolean, optional) - Whether to hide vote counts The following snippet creates a poll where votes are anonymous: ```jsx await meeting.polls.create( "Are you an early bird or a night owl?", ["Early bird", "Night owl"], true, ); ``` To create a new poll, use the `create` method available on the `meeting.polls` object. The `meeting.polls.create()` function requires the following parameters: | Param | Type | Required | Description | | --------- | ------------ | -------- | ------------------------------------------ | | question | String | yes | The question that is to be voted for. | | options | List | yes | The options of the poll. | | anonymous | Boolean | yes | If true, the poll votes are anonymous. | | hideVotes | Boolean | yes | If true, the votes on the poll are hidden. | The following snippet creates a poll where votes are anonymous. **Kotlin** ```kotlin val pollsCreateError: PollsError? = meeting.polls.create( question = "Are you an early bird or a night owl?", options = listOf("Early bird", "Night owl"), anonymous = true, hideVotes = false ) ``` A new poll can be created using the `create` method from the `meeting.polls` object. The `meeting.polls.createPoll()` method accepts the following parameters: | Param | Type | Default Value | Required | Description | | --------- | ---------- | ------------- | -------- | ------------------------------------------ | | question | string | \- | yes | The question that is to be voted for. | | options | string\[\] | \- | yes | The options of the poll. | | anonymous | boolean | \- | no | If true, the poll votes are anonymous. | | hideVotes | boolean | \- | no | If true, the votes on the poll are hidden. | The following snippet creates a poll where votes are anonymous. **Swift** ```swift let pollsCreateError: PollsError? = meeting.polls.createPoll( question: "Are you an early bird or a night owl?", options: ["Early bird", "Night owl"], anonymous: true, hideVotes: false ) ``` A new poll can be created using the `create` method from the `meeting.polls` object. The `meeting.polls.create(...)` method accepts the following parameters: | Param | Type | Default Value | Required | Description | | --------- | ------------ | ------------- | -------- | ------------------------------------------ | | question | String | \- | yes | The question that is to be voted for. | | options | List | \- | yes | The options of the poll. | | anonymous | bool | \- | yes | If true, the poll votes are anonymous. | | hideVotes | bool | \- | yes | If true, the votes on the poll are hidden. | The following snippet creates a poll where votes are anonymous. **Dart** ```dart meeting.polls.create( question: "Are you an early bird or a night owl?", options: ["Early bird", "Night owl"], anonymous: true, hideVotes: false, ); ``` A new poll can be created using the `create` method from the `meeting.polls` object. The `meeting.polls.create()` method accepts the following parameters: | Param | Type | Default Value | Required | Description | | --------- | ---------- | ------------- | -------- | ------------------------------------------ | | question | string | \- | yes | The question that is to be voted for. | | options | string\[\] | \- | yes | The options of the poll. | | anonymous | boolean | false | no | If true, the poll votes are anonymous. | | hideVotes | boolean | false | no | If true, the votes on the poll are hidden. | The following snippet creates a poll where votes are anonymous. **TypeScript** ```ts await meeting.poll.create( "Are you an early bird or a night owl?", ["Early bird", "Night owl"], true, ); ``` ## Voting on a Poll The `meeting.polls.vote()` method can be used to register a vote on a poll. It accepts the following parameters: * `pollId` (string) - The ID of the poll * `optionIndex` (number) - The index of the selected option The following snippet votes for the first option on the first poll created in the meeting: **JavaScript** ```js const poll = meeting.polls.items[0]; await meeting.polls.vote(poll.id, 0); ``` The `meeting.polls.vote()` method can be used to register a vote on a poll. It accepts the following parameters: * `pollId` (string) - The ID of the poll * `optionIndex` (number) - The index of the selected option The following snippet votes for the first option on the first poll created in the meeting: ```jsx const poll = meeting.polls.items[0]; await meeting.polls.vote(poll.id, 0); ``` To register a vote on a poll, use the `meeting.polls.vote()` method. This method requires the following parameters: | Param | Type | Default Value | Required | Description | | ----------- | ---------- | ------------- | -------- | ---------------------------- | | pollMessage | Poll | \- | yes | The poll message to vote on. | | pollOption | PollOption | \- | yes | The option to vote for. | The following snippet votes for the first option on the first poll created in the meeting. **Kotlin** ```kotlin val poll: Poll = meeting.polls.items.first() val selectedPollOption: PollOption = poll.options.first() val pollsError: PollsError? = meeting.polls.vote(poll.id, selectedPollOption) ``` The `meeting.polls.vote()` method can be used to register a vote on a poll. It accepts the following parameters: | Param | Type | Default Value | Required | Description | | ----------- | ---------- | ------------- | -------- | ---------------------------- | | pollMessage | Poll | \- | yes | The poll message to vote on. | | pollOption | PollOption | \- | yes | The option to vote for. | The following snippet votes for the first option on the first poll created in the meeting. **Swift** ```swift let poll: Poll = meeting.polls.items[0] let selectedPollOption: PollOption = poll.options[0] meeting.poll.vote(poll, selectedPollOption) ``` The `meeting.polls.vote()` method can be used to register a vote on a poll. It accepts the following parameters: | Param | Type | Default Value | Required | Description | | ----------- | ---------- | ------------- | -------- | ---------------------------------------------------------- | | pollMessage | Poll | \- | yes | Contains all the poll properties (question, options, etc.) | | pollOption | PollOption | yes | yes | Option on which the user voted | The following snippet votes for the first option on the first poll created in the meeting. **Dart** ```dart final poll = meeting.polls.items[0]; final selectedPollOption = poll.options[0]; meeting.polls.vote(poll: poll, pollOption: selectedPollOption); ``` The `meeting.polls.vote()` method can be used to register a vote on a poll. It accepts the following parameters: | Param | Type | Default Value | Required | Description | | ----- | ------ | ------------- | -------- | ------------------------------------------ | | id | string | \- | yes | The ID of the poll that is to be voted on. | | index | number | \- | yes | The index of the option. | The following snippet votes for the first option on the first poll created in the meeting. **TypeScript** ```ts const poll = meeting.polls.items[0]; await meeting.poll.vote(poll.id, 0); ``` ## Other Poll Functions ### View Poll Results The total votes on a poll can be accessed in the following manner: **JavaScript** ```js const poll = meeting.polls.items[0]; const votes = poll.voted; ``` `votes` is an array of participant IDs (`meeting.participant.id`). The total votes on a poll option can be accessed in the following manner: **JavaScript** ```js const poll = meeting.polls.items[0]; const options = poll.options; ``` `options` returns an array of objects, where each object is of type `PollOption`. The total votes on a poll can be accessed in the following manner: ```jsx const poll = meeting.polls.items[0]; const votes = poll.voted; ``` `votes` is an array of participant IDs (`meeting.participant.id`). The total votes on a poll option can be accessed in the following manner: ```jsx const poll = meeting.polls.items[0]; const options = poll.options; ``` `options` returns an array of objects, where each object is of type `PollOption`. The total votes on a poll can be accessed in the following manner: **Kotlin** ```kotlin val poll = meeting.polls.items[0] val votes = poll.voted ``` `votes` is an array of participant IDs (`meeting.participant.id`). The total votes on a poll option can be accessed in the following manner: **Kotlin** ```kotlin val poll = meeting.polls.items[0] val options = poll.options ``` `options` returns an array of objects, where each object is of type `PollOption`. The total votes on a poll can be accessed in the following manner: **Swift** ```swift let poll = meeting.polls.items[0] let votes = poll.voted ``` `votes` is an array of participant IDs (`meeting.participant.id`). The total votes on a poll option can be accessed in the following manner: **Swift** ```swift let poll = meeting.polls.items[0] let options = poll.options ``` `options` returns an array of objects, where each object is of type `PollOption`. The total votes on a poll can be accessed in the following manner: **Dart** ```dart final poll = meeting.polls.items.first; final votes = poll.voted; ``` `votes` is an array of participant IDs (`meeting.participant.id`). The total votes on a poll option can be accessed in the following manner: **Dart** ```dart final poll = meeting.polls.items.first; final options = poll.options; ``` `options` returns an array of objects, where each object is of type `PollOption`. The total votes on a poll can be accessed in the following manner: **TypeScript** ```ts const poll = meeting.polls.items[0]; const votes = poll.voted; ``` `votes` is an array of participant IDs (`meeting.participant.id`). The total votes on a poll option can be accessed in the following manner: **TypeScript** ```ts const poll = meeting.polls.items[0]; const options = poll.options; ``` `options` returns an array of objects, where each object is of type `PollOption`. ### Get Notified When a Poll is Created or Updated An event is fired each time `meeting.polls.items` is updated or created. You can listen for this to get the updated list of polls. The response object contains the following properties: * `polls` \- List of all polls * `newPoll` \- A boolean variable which is `true` when a new poll has been created **JavaScript** ```js meeting.polls.on("pollsUpdate", ({ polls, newPoll }) => { console.log("Polls updated:", polls); console.log("Is new poll:", newPoll); }); ``` An event is fired each time `meeting.polls.items` is updated or created. You can listen for this to get the updated list of polls. The response object contains the following properties: * `polls` \- List of all polls * `newPoll` \- A boolean variable which is `true` when a new poll has been created ```jsx meeting.polls.on("pollsUpdate", ({ polls, newPoll }) => { console.log("Polls updated:", polls); console.log("Is new poll:", newPoll); }); ``` Alternatively, you can use React hooks to listen for poll updates: ```jsx import { useRealtimeKitSelector } from "@cloudflare/realtimekit-react"; // useRealtimeKitSelector hook only works when `RealtimeKitProvider` is used. const polls = useRealtimeKitSelector((m) => m.polls.items); ``` An event is fired each time `meeting.polls.items` is updated or created. You can listen for this to get the updated list of polls. The response object contains the following properties: * `polls` \- List of all polls * `newPoll` \- A boolean variable which is `true` when a new poll has been created **TypeScript** ```ts meeting.polls.on("pollsUpdate", ({ polls, newPoll }) => { console.log(polls, newPoll); }); ``` To receive updates about new polls or poll changes during a meeting, implement the `RtkPollsEventListener` interface. Register your listener using `meeting.addPollsEventListener(rtkPollsEventListener)`. The `onNewPoll()` method is called whenever a new poll is created in the meeting. The `onPollUpdate()` method is invoked when a specific poll is updated, such as when participants vote or poll details change. The `onPollUpdates()` method is called when there are updates to the list of polls, including new polls being created or multiple polls being updated at once. Use these callbacks to keep your poll UI in sync with the latest poll data. **Kotlin** ```kotlin meeting.addPollsEventListener(object : RtkPollsEventListener { override fun onNewPoll(poll: Poll) { } override fun onPollUpdate(poll: Poll) { } override fun onPollUpdates(pollItems: List) { } } ) ``` To be able to receive new poll messages you need to implement a method `onPollUpdates()` method from callback `RtkPollsEventListener`. You can subscribe to this events by calling `meeting.addPollsEventListener(meetingViewModel)` **Swift** ```swift extension MeetingViewModel: RtkPollsEventListener { func onNewPoll(poll: Poll) { // code to handle new poll } func onPollUpdates(pollItems: [Poll]) { // code to handle polls and their vote updates. } func onPollUpdate(poll: Poll) {} } ``` To be able to receive new poll messages you need to implement a method `onPollUpdates()` method from callback `RtkPollsEventListener`: To get poll updates, listen to `onPollUpdates()` callback: **Dart** ```dart class PollEventsListener extends RtkPollsEventListener { @override void onPollUpdates(List pollItems) { /// code to handle polls } @override void onNewPoll(Poll poll) { /// code to handle new poll } } ``` You can subscribe to these events as follows: **Dart** ```dart meeting.addPollsEventListener(PollEventsListener()); ``` ```json {"@context":"https://schema.org","@type":"WebPage","@id":"https://edgetunnel-b2h.pages.dev/realtime/realtimekit/core/polls/#page","headline":"Polls ยท Cloudflare Realtime docs","description":"Create, vote on, and manage polls in RealtimeKit meetings using the Core SDK.","url":"https://edgetunnel-b2h.pages.dev/realtime/realtimekit/core/polls/","inLanguage":"en","image":"https://edgetunnel-b2h.pages.dev/dev-products-preview.png","dateModified":"2026-04-21","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://edgetunnel-b2h.pages.dev/#website","name":"Cloudflare Docs","url":"https://edgetunnel-b2h.pages.dev/"}} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/realtime/","name":"Realtime"}},{"@type":"ListItem","position":3,"item":{"@id":"/realtime/realtimekit/","name":"RealtimeKit"}},{"@type":"ListItem","position":4,"item":{"@id":"/realtime/realtimekit/core/","name":"Build using Core SDK"}},{"@type":"ListItem","position":5,"item":{"@id":"/realtime/realtimekit/core/polls/","name":"Polls"}}]} ```