Multiple Options
Create polls with 2-10 answer options
Time Limits
Set custom voting deadlines or keep open indefinitely
Overview
Poll posts enable interactive community engagement by allowing users to vote on questions. Create polls with multiple options, set time limits, and track real-time voting results.A Poll must be created first before creating the post. See Poll Creation Guidelines for instructions.
1
Create Poll
Use the Poll Repository to create a poll with questions and options
2
Create Post
Create a post using the poll ID with optional description text
3
Share & Engage
Users can vote and see real-time results in their feeds
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
text | String | Yes | Post content (max 20,000 characters) |
pollId | String | Yes | ID of the created poll |
targetType | Enum | Yes | Target destination (community or user feed) |
tags | Array | No | Searchable tags (not available in Flutter) |
metadata | Object | No | Custom fields for extended functionality |
Troubleshooting
Poll Creation Failures
Poll Creation Failures
Problem: Poll creation fails before post creationSolutions:
- Verify poll question is not empty
- Ensure at least 2 options are provided
- Check option text length limits
- Validate time limit values are positive
Poll Post Linking Issues
Poll Post Linking Issues
Problem: Post creation fails with invalid poll IDSolutions:
- Verify poll was created successfully
- Check poll ID is correctly passed to post creation
- Ensure poll hasn’t been deleted
Voting Permission Issues
Voting Permission Issues
Problem: Users cannot vote on pollsSolutions:
- Check if poll is still open (not expired)
- Verify user has permission to vote in the target community
- Ensure user hasn’t already voted (for single-vote polls)
- Confirm poll wasn’t closed by moderators
Results Display Issues
Results Display Issues
Problem: Poll results not updating or displaying incorrectlySolutions:
- Implement real-time updates for poll results
- Refresh results when poll post is viewed
- Handle cases where vote counts are not available
- Provide fallback UI for loading states
Common Use Cases
Community Feedback
Gather opinions on community decisions and improvements
Event Planning
Coordinate dates, times, and preferences for events
Product Research
Collect user preferences and feature requests
Quick Surveys
Run simple polls for engagement and data collection