Skip to main content
SDK v7.x · Last verified March 2026 · iOS · Android · Web · Flutter
// 1. Create a poll
const { data: poll } = await PollRepository.createPoll({
  question: 'Favorite color?', answerType: 'single',
  answers: [{ dataType: 'text', data: 'Red' }, { dataType: 'text', data: 'Blue' }],
});

// 2. Wrap it in a post
await PostRepository.createPollPost({
  pollId: poll.pollId, targetType: 'community', targetId: 'communityId',
});

// 3. Vote
await PollRepository.votePoll(poll.pollId, ['answerId-1']);

// 4. Close the poll
await PollRepository.closePoll(poll.pollId);
Full walkthrough below ↓
Platform note — code samples below use TypeScript. Every method has an equivalent in the iOS (Swift), Android (Kotlin), and Flutter (Dart) SDKs — see the linked SDK reference in each step.
Polls are one of the highest-engagement content types in social apps. social.plus provides a full poll lifecycle: create the poll, wrap it in a feed post, let users vote (and change their vote), and close or delete when done. All four platforms are supported — iOS, Android, TypeScript, and Flutter.
Polls are always published as part of a post — there are no standalone polls in the current SDK. The two-step flow (create poll → create post) is by design so polls appear in feeds like any other content.
Image polls: Poll answers can include images instead of text — useful for “Which design do you prefer?” or “Which product looks better?” questions. Set answer.dataType: 'image' and provide a fileId (upload the image first) for each visual option. See Poll Posts for the full answer object structure.
After completing this guide you’ll have:
  • Poll creation embedded inside a feed post (single and multiple choice)
  • Voting, vote-change, and poll-close flows implemented
  • Vote counts updating in real-time in your feed

​
Limits at a Glance

PropertyLimit
Max poll options10
Min poll options2
Answer typessingle or multiple
Answer data typestext or image
Question length500 characters
Poll closureManual close or auto-expire via closedIn
Vote changesAllowed until poll closes

​
Quick Start: Create a Poll and Publish It

TypeScript
import { PollRepository, PostRepository } from '@amityco/ts-sdk';

try {
  // Step 1: Create the poll
  const { data: poll } = await PollRepository.createPoll({
    question: 'What feature should we build next?',
    answerType: 'single',
    answers: [
      { dataType: 'text', data: 'Dark mode' },
      { dataType: 'text', data: 'Offline support' },
      { dataType: 'text', data: 'Video reactions' },
    ],
  });

  // Step 2: Publish as a community post
  const { data: post } = await PostRepository.createPollPost({
    pollId: poll.pollId,
    text: 'Help us prioritise our roadmap! 👇',
    targetType: 'community',
    targetId: communityId,
  });
} catch (error) {
  console.error('Failed to create poll post:', error);
}
Full reference → Polls · Poll Posts

​
Step-by-Step Implementation

1

Create the poll

Create the poll object first. Choose 'single' for one answer or 'multiple' for multi-select. Set timeToClosePoll in milliseconds — omit it for a poll that stays open until you manually close it.
TypeScript
import { PollRepository } from '@amityco/ts-sdk';

const { data: poll } = await PollRepository.createPoll({
  question: 'Which platform are you building on?',
  answerType: 'single',   // or 'multiple' for multi-select
  answers: [
    { dataType: 'text', data: 'iOS' },
    { dataType: 'text', data: 'Android' },
    { dataType: 'text', data: 'Web' },
    { dataType: 'text', data: 'Flutter' },
  ],
  // Optional: close automatically after 24 hours
  // timeToClosePoll: 24 * 60 * 60 * 1000,
});

const pollId = poll.pollId;
Full reference → Polls
2

Publish as a post in a feed

Create a poll post with the pollId. Add context text as the post caption — this is what users see before expanding the poll.
TypeScript
import { PostRepository } from '@amityco/ts-sdk';

const { data: post } = await PostRepository.createPollPost({
  pollId,
  text: 'Tell us what you think! Results shared next week.',
  targetType: 'community',   // 'community' or 'user'
  targetId: communityId,
});
Full reference → Poll Posts
3

Let users vote

Pass the poll ID and an array of answer IDs. For single polls, the array will have one item. For multiple, users can select up to all options.
TypeScript
import { PollRepository } from '@amityco/ts-sdk';

// Cast the vote
const { data: updatedPoll } = await PollRepository.votePoll(
  poll.pollId,
  [selectedAnswerId]   // array of answer IDs
);

// Show updated vote counts immediately
updatedPoll.answers.forEach(answer => {
  console.log(`${answer.data}: ${answer.voteCount} votes`);
});
Full reference → Polls
4

Allow users to change their vote

Users can unvote and re-vote as long as the poll is still open. Call unvotePoll first, then votePoll with the new selection.
TypeScript
import { PollRepository } from '@amityco/ts-sdk';

// Remove existing vote
await PollRepository.unvotePoll(poll.pollId);

// Cast a new vote
await PollRepository.votePoll(poll.pollId, [newAnswerId]);
Full reference → Polls
5

Close the poll manually

Poll owners and admins can close a poll early — for example, after a timed announcement. Once closed, no new votes are accepted and results are final.
TypeScript
import { PollRepository } from '@amityco/ts-sdk';

const { data: closedPoll } = await PollRepository.closePoll(poll.pollId);

// closedPoll.isVotable === false — show results, hide vote button
if (!closedPoll.isVotable) {
  showFinalResults(closedPoll);
}
Full reference → Polls
6

Delete a poll

Permanently removes the poll and all vote data. Only the poll creator or an admin can delete. The associated post should also be deleted separately.
TypeScript
import { PollRepository } from '@amityco/ts-sdk';

const isDeleted = await PollRepository.deletePoll(poll.pollId);
Full reference → Polls

​
Rendering Poll Results

Use the poll’s answers array to render a visual results bar. Show current vote percentages while the poll is open, and pin the winner after it closes.
TypeScript
function renderPollResults(poll: Amity.Poll) {
  const totalVotes = poll.answers.reduce((sum, a) => sum + a.voteCount, 0);

  return poll.answers.map(answer => ({
    text: answer.data,
    votes: answer.voteCount,
    percentage: totalVotes > 0 ? Math.round((answer.voteCount / totalVotes) * 100) : 0,
    isSelected: answer.isVoted,   // true if current user voted for this option
  }));
}

​
Connect to Moderation & Analytics

Use the pin-post API to pin a poll post to the top of a community feed during active voting.→ Pin Post
Poll posts can be flagged by users and reviewed in Admin Console → Moderation → Flagged Content like any other post type.
Receive post.created and post.updated events for poll posts to trigger downstream actions like push notifications to community members when a new poll is published.→ Webhook Events

​
Common Mistakes

Creating a poll with fewer than 2 answers — The API requires at least 2 answer options. Validate your form before calling createPoll.
Forgetting to close polls — Polls without a closedAt date stay open forever. If your poll is time-bound, either set closedAt at creation or call closePoll explicitly when the window ends.
Displaying results before the user votes — Showing percentages before voting biases choices. Hide results until the current user has voted or the poll is closed.

​
Best Practices

  • Keep questions under 100 characters — readable at a glance in a feed card
  • Provide 2–5 options for most polls; more than 6 reduces completion rates
  • Avoid vague options like “Option A” — every answer should be self-explanatory without reading the question
  • Use 'multiple' answer type for taste/preference questions, 'single' for factual or decision polls
  • Check poll.isVotable before showing the vote button — hide it entirely when false
  • Highlight the winning option (most votes) with a distinct visual treatment after close
  • Show the total vote count prominently — social proof drives engagement on future polls
  • Keep the poll post visible in the feed after closing; don’t delete it just because voting has ended
  • Subscribe to the post live object to receive vote count updates without manual refresh
  • Animate the percentage bar as it changes — a smooth transition feels more alive than a jump
  • Debounce vote button presses to prevent accidental double-votes
Dive deeper: Posts API Reference has full parameter tables, method signatures, and platform-specific details for every API used in this guide.

​
Next Steps

Your next step → Comments & Reactions

Polls are interactive — now add comments and reactions so users can discuss the results.
Or explore related guides:

Rich Content Creation

Polls alongside all other post types in one guide

Community Platform

Publish polls to community feeds with pinning support

Notifications & Engagement

Notify members when a new poll is published