Polls Plugin

Renders poll messages with question, voting options, and real-time vote counts.

AI Integration Quick Reference

Field	Value
Plugin ID	polls
Package	@cometchat/chat-uikit-react
Message Types	extension_poll
Message Categories	custom
Included by Default	Yes
Bubble Component	CometChatPollBubble
Conversation Preview	Poll question text (truncated)
Context Menu	React, Reply, Reply in Thread, Info, Delete, Report, Mark Unread, Message Privately

Overview

The Polls plugin handles messages of type extension_poll in category custom. It renders an interactive poll bubble where users can vote on options and see real-time results.

---

Bubble Rendering

• Question — displayed as the poll title
• Options — clickable vote buttons with option text
• Results — percentage bars showing vote distribution after voting
• Vote count — total number of votes
• Lazy-loaded — the bubble component is not included in the initial bundle

The poll data is extracted from the message’s customData:

{
  "question": "What's for lunch?",
  "options": { "1": "Pizza", "2": "Sushi", "3": "Tacos" },
  "results": { "total": 5, "options": { "1": 3, "2": 1, "3": 1 }, "voters": {} }
}

---

Context Menu Options

Standard media options: React, Reply, Reply in Thread, Info, Delete, Report, Mark Unread, Message Privately.

---

Conversation Preview

Returns the poll question text (truncated to 80 characters). Falls back to Poll if no question is found.

---

CSS Selectors

Target	Selector
Bubble root	.cometchat-poll-bubble
Question	.cometchat-poll-bubble__question
Option	.cometchat-poll-bubble__option
Progress bar	.cometchat-poll-bubble__progress
Vote count	.cometchat-poll-bubble__vote-count