Badge System
Badges are NFT-backed digital achievements that recognize member contributions. When members reach XP thresholds within a specific space, they automatically earn badges for that space. Each badge showcases engagement level and can unlock special privileges like exclusive voting rights.
Understanding Badges
Per-Space Badge Tracking
Key Concept: Badges are earned and tracked separately for each space. When you reach 50 XP in "Momentum Sports", you earn a badge in Momentum Sports only. The same applies to every other space you participate in.
This means:
Badges belong to spaces — Your Bronze badge in Space A is independent of Space B
You can earn duplicate badge types — Bronze in Space A AND Bronze in Space B
Each space defines its own badges — Space A might have "Bronze Athlete", Space B might have "Bronze Member"
Badge requirements are space-specific — 50 XP in Space A, 100 XP in Space B (each admin configures independently)
Badge Properties
Each badge has:
Name — A descriptive title (e.g., "Gold Member", "Platinum Athlete")
Description — Explains what the badge represents
Rarity Tier — Common, Uncommon, Rare, Epic, or Legendary
XP Threshold — The experience points required to earn the badge (in that space)
Badge Type — Unique identifier (e.g., "gold_member")
Organization — The space this badge belongs to
Rarity Tiers
Common
Gray
Entry-level recognition, first milestone
Uncommon
Green
Regular contributors, consistent engagement
Rare
Blue
Above-average participation, quality contributions
Epic
Purple
Top performers, significant commitment
Legendary
Gold
Elite status, exceptional community leaders
Creating Badges
Step 1: Access Badge Settings
Navigate to Settings from the sidebar
Click the Badges tab
Step 2: Create a New Badge
Click Create Badge and fill in:
Name (required)
Keep it descriptive and aspirational
Examples: "Gold Member", "Community Champion", "Innovation Leader"
Description (required)
Explain what this badge represents
Describe the achievement being recognized
Badge Type (required)
Unique identifier for the badge
Use lowercase with underscores: "gold_member", "community_champion"
Rarity (required)
Select from Common to Legendary
Higher rarity = more prestige
XP Threshold (required)
Set the minimum XP needed to earn this badge in your space
Members automatically receive the badge when they reach this threshold in your space
Step 3: Save
Click Save Badge to create it. The badge immediately becomes available and will be awarded to any members who already meet the XP threshold in your space.
Default Badge Templates
Don't want to start from scratch? Vora provides default badges via API:
Bronze Member
Common
50 XP
Silver Member
Uncommon
100 XP
Gold Member
Rare
500 XP
Platinum Member
Epic
1,000 XP
Diamond Member
Legendary
5,000 XP
You can edit or delete these defaults after creation. Each space can customize badge names and thresholds.
Managing Badges
Editing a Badge
Click the Edit icon on any badge card
Modify the name, description, rarity, or XP threshold
Click Save Changes
Note: Changing the XP threshold may cause members to gain or lose badge status in your space.
Deleting a Badge
Click the Delete icon on the badge card
Confirm deletion
Warning: Deleting a badge removes it from all members who earned it in your space. If the badge is used for voting eligibility, those members will lose their voting rights on badge-restricted proposals.
Deactivating a Badge
Rather than deleting, you can deactivate a badge by setting its status to inactive. The badge remains on member profiles but won't be awarded to new members.
Badge Display
On Profile Dashboard
Members can view their earned badges on their profile dashboard in two ways:
Badges Section (Header):
Total badge count across all spaces
XP by Space Section:
Each space card shows the badge count earned in that specific space
Clicking a space shows which badges were earned there
Badges Tab:
Complete list of all earned badges
Each badge shows which space it was earned in
Badge details include name, rarity, and earned date
In Voting
When Badge Earner voting mode is active, the system checks if the member holds the required badge in that specific space to determine voting eligibility.
Per-Space Badge Examples
User Profile Example:
Each badge is tied to the space where it was earned. The user's profile clearly shows which space each badge belongs to.
Blockchain Verification
All badges are minted as NFTs on the Base Mainnet blockchain (Coinbase's Ethereum L2), providing:
Immutable Proof — Badge ownership is permanently recorded
Transparency — Badge authenticity can be verified on-chain
Per-Space Tracking — The NFT metadata includes the space (organization) where it was earned
The NFT minting happens automatically when a badge is earned — no crypto knowledge required from members.
Best Practices
Tiered Progression
Create a clear path from entry-level to elite within your space:
Meaningful Thresholds
Set thresholds that reflect real engagement in your space
Avoid making top badges too easy (devalues achievement)
Avoid making them impossible (discourages participation)
Consider your typical XP rewards when setting thresholds
Descriptive Names
Use names that resonate with your community:
Tech community: "Code Wizard", "Bug Hunter", "Architecture Guru"
Fashion brand: "Trendsetter", "Style Icon", "Fashion Pioneer"
Sports brand: "Bronze Athlete", "Silver Champion", "Gold Legend"
Sustainability org: "Eco Warrior", "Green Champion", "Planet Protector"
Cross-Space Considerations
If you operate multiple spaces, consider:
Using consistent naming conventions (Bronze/Silver/Gold)
Setting similar thresholds for fairness
Or intentionally varying to reflect different community dynamics
Related Features
XP & Rewards — How members earn XP in each space
Badge Earner Voting Mode — Restrict voting to badge holders
Proposal Voting Override — Per-proposal badge requirements
Last updated