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.

  1. Navigate to Proposals from the sidebar

  2. Click + New Proposal

  3. 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"

circle-info

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.

circle-exclamation

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.

circle-info

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.

Last updated