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

Creating Badges

Step 1: Access Badge Settings

1. Navigate to Settings from the sidebar
2. 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:

You can edit or delete these defaults after creation. Each space can customize badge names and thresholds.

Managing Badges

Editing a Badge

1. Click the Edit icon on any badge card
2. Modify the name, description, rarity, or XP threshold
3. Click Save Changes

Note: Changing the XP threshold may cause members to gain or lose badge status in your space.

Deleting a Badge

1. Click the Delete icon on the badge card
2. 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:

Total Badges: 3

XP by Space:
+-- Momentum Sports (120 XP)
|   +-- Bronze Athlete badge
|
+-- Summit Fitness (60 XP)
|   +-- Bronze Member badge
|
+-- EcoThread (200 XP)
    +-- Silver Advocate badge

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:

50 XP -> Bronze (Common)
100 XP -> Silver (Uncommon)
500 XP -> Gold (Rare)
1000 XP -> Platinum (Epic)
5000 XP -> Diamond (Legendary)

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