Creating a Proposal
The Customer Voting module is the core of Vora. It lets you create proposals structured questions with voting options that your customers vote on.
- Navigate to Proposals from the sidebar
- Click + New Proposal
- Fill in the proposal form:
| Field | Description | Required |
|---|---|---|
| Title | A clear, concise question (e.g., "Which color should we release next?") | Yes |
| Description | Full context - explain what you're asking and why it matters. Supports rich text. | Yes |
| Proposal Type | Category of the decision (see below) | Yes |
| Proposal Ending | How the proposal closes - by time, vote count, or voting power (see below) | Yes |
| Choices | The voting options. Add between 2 and 10 options. | Yes |
| Voting Strategy | How votes are weighted and counted - see Voting Strategies for full details | Yes |
| Quorum | Minimum percentage of voters required for the result to be valid | Optional |
| Visibility | Whether results are public or private during voting | Yes |
| Voter Rewards | Attach rewards that voters automatically receive when the proposal closes. Reward emails include results summary and a View Results link. See Voter Rewards | Optional |
Proposal Types
Choose the category that best describes your proposal:
- Product Decision - Colors, features, packaging, materials
- Feature Request - New functionality or improvements
- Limited Edition - Special release decisions
- Community Initiative - Community programs and partnerships
- Treasury Allocation - Budget and spending decisions
- Governance - Rule or policy changes
- Custom - Any other type of decision
Proposal Ending Options
When creating a proposal, you choose how it ends. The three options are mutually exclusive - each proposal uses exactly one.
| Ending Mode | How it works | When to use |
|---|---|---|
| Voting Duration | Closes automatically after a set time period (24h, 48h, 72h, 1 week, 2 weeks, or 1 month) | When you want a fixed voting window - the most common option |
| Number of Votes | Closes automatically when a target number of votes is reached | When you need a specific sample size before making a decision (e.g., "I need at least 100 responses") |
| Total Voting Power | Closes automatically when the total accumulated voting power reaches a target | When using weighted voting strategies and you need a certain level of participation weight |
How it looks on the form:
The Proposal Ending dropdown and its target field appear side by side. When you select an ending mode, the corresponding configuration field appears next to it:
- Voting Duration -> A duration dropdown (24 hours to 1 month)
- Number of Votes -> A number input for the target vote count
- Total Voting Power -> A number input for the target voting power
What voters see:
On the proposal detail page, the timeline section adapts based on the ending mode:
- Duration mode - Shows the end date and a "X days left" countdown
- Vote count mode - Shows "X / Y votes" progress and "Z votes remaining"
- Voting power mode - Shows "X / Y" power progress and "Z power remaining"
Note
Auto-close is immediate. When the target is reached (vote count or voting power), the proposal closes right away - results are calculated and notifications are sent to followers instantly.
Warning
Ending mode cannot be changed after votes are cast. You can modify the ending mode and its target while a proposal has zero votes. Once the first vote is recorded, the ending configuration is locked.
Voting Strategy
The voting strategy determines how much weight each voter's vote carries. You select one strategy per proposal. Vora supports 7 strategies:
| Strategy | Summary |
|---|---|
| One Person, One Vote | Equal weight for everyone - the default |
| Multiple Vote (Passion) | Voters can vote multiple times to express intensity |
| Group-Based Power | Weight based on Voter Group membership |
| Tenure/Seniority Based | Weight grows with membership duration |
| Engagement Score Based | Weight scales with user engagement activity |
| Role-Based Tiers | Fixed weights per organizational role |
| Quadratic (Anti-Whale) | Square root of group power - diminishing returns |
When you select a strategy, the form will display its configurable parameters (e.g., max votes, base weight, multiplier). Each parameter has sensible defaults - you can keep them as-is or adjust to your needs.
For full details on each strategy including formulas, parameters, and practical examples, see Voting Strategies.
Voter Rewards (Optional)
Below the media section, you'll find the Voter Rewards card. This lets you attach rewards that are automatically distributed to eligible voters when the proposal closes.
When a rewarded proposal closes, every eligible voter receives a single email that includes:
- The governance outcome - which option won and by how much
- The reward details - title, instructions, claim code, QR code (for local rewards)
- A View Full Results button linking back to the proposal
This unified email replaces the need for separate close notifications. To customize what voters read, use the reward's Email Instruction field when creating the reward.
Note
No rewards? No close email. If you don't attach a reward, voters won't receive a close email (followers still get notified). To ensure every voter hears from you, attach a simple "Thank You" custom reward with your message in the Email Instruction field.
For full details, see Voter Rewards and What Happens When a Proposal Closes.