Attaching Rewards to Proposals

Once you've created a reward, the next step is attaching it to a proposal. This is what triggers automatic distribution when the proposal closes.

How to Attach

When creating or editing a proposal, you'll see a Rewards section in the proposal form:

  1. Go to Proposals+ New Proposal (or edit an existing one)

  2. Scroll to the Rewards section

  3. Click + Add Reward

  4. Select one or more rewards from your list

  5. Each selected reward appears as a tag with an info tooltip showing its details

  6. Continue filling in the rest of the proposal form and publish

What Voters See

When a proposal has rewards attached, voters see:

  • A gift icon on the proposal card in the proposals list — this signals that voting comes with a tangible reward

  • The reward details (title and type) on the proposal detail page

  • After voting, a confirmation that they'll receive their reward when the proposal closes

circle-info

The gift icon is your best engagement tool. Proposals with the gift icon consistently attract more attention. Use it strategically on the proposals where you need the highest participation.

Multiple Rewards per Proposal

You can attach multiple rewards to a single proposal. Each reward is distributed independently based on its own eligibility rules:

Example:

  • Reward A: "10% Off" for All Voters

  • Reward B: "Free Product" for Winner Voters only

Result when proposal closes:

  • Every voter gets the 10% discount code

  • Only voters who chose the winning option also get the free product

  • A voter who chose the winner gets two reward emails

Timing

  • Rewards can be attached before publishing or while the proposal is active

  • Adding a reward to an active proposal is fine — it doesn't affect existing votes

  • Rewards are distributed at the moment the proposal closes, regardless of when they were attached

  • You cannot attach rewards after a proposal has closed — the distribution has already happened

What Happens at Close

When a proposal closes (either by reaching its ending condition or being manually closed):

  1. Vora's results engine calculates the winner

  2. For each attached reward, eligible voters are identified based on the reward's eligibility rule (all/winner/loser)

  3. A RewardClaim is created for each eligible voter

  4. Each claim gets a unique claim code and verification hash

  5. A single unified email is sent to every eligible voter with a verified email address, containing:

    • The results summary (winning choice + percentage, or quorum status)

    • The reward details (title, type, instructions, claim code)

    • A View Full Results button linking to the proposal page

    • For local rewards, an inline QR code for in-person verification

  6. A GDPR audit log entry is created for each email sent

This entire process is automatic — no admin action required at distribution time. The reward email is the only close email voters receive, combining governance results with reward delivery in one clean message.

Last updated