Adding benefits to badges
How to create and attach benefits that make your badges valuable
Overview
Benefits are what transform badges from simple collectibles into valuable community assets. They provide tangible perks that reward holders and create lasting engagement.
Two types of benefits:
Static: Always active for badge holders (access, privileges)
Claimable: Require action to redeem (merchandise, rewards)
Step 1: Create a benefit
Access benefits management
Log in to your admin portal
Navigate to Benefits in the left sidebar
Click Create benefit button
Benefit information
Benefit name: Clear, descriptive title that explains what the benefit is.
Examples: "Exclusive Content Access", "Free Vinyl Claim", "10% Discount Code"
Benefit description: Explain what the benefit provides and any important details.
Be specific about what holders receive
Include limitations or renewal periods if applicable
Example: "A small discount on the merchandise site"
Benefit image: Visual representation displayed in collection views.
Helps users quickly identify benefits
Use clear, recognizable icons or branded graphics
Step 2: Select benefit type
Static benefits (Access type)
What they are: Automatically active for anyone holding the badge. No claiming required.
Common uses:
Access to exclusive content feed
Ability to post in community
Token-gated features
Priority support
Special recognition or status
Configuration:
Type: Access
Claim type: Static
No additional setup needed
Example: "Access to exclusive contents module" - Badge holders automatically gain access to private content feed.
Claimable benefits
Benefits that require the holder to take action to redeem.
Email Claim Benefits
What they are: Admin receives email notification when member claims benefit. Admin handles fulfillment manually.
Best for:
Physical merchandise requiring shipping coordination
Custom/personalized items
Benefits needing approval or verification
Small-scale, hands-on fulfillment
Configuration:
Type: Email
Claim type: Claimable
Admin email address: Where notifications are sent
Renewable benefit: Toggle ON if claimable again after time period
Renewal period (in days): How long until benefit can be claimed again
Number of renewals: Total times benefit can be claimed (0 = infinite)
How it works:
Member clicks "Claim" button in their dashboard
System sends email to admin with member's information
Admin processes claim and handles fulfillment
Member receives confirmation email
Example workflow - Physical art print:
Member claims free print benefit
Admin receives notification with member's wallet address
Admin contacts member for shipping details via email
Admin ships print and confirms with member
After 365 days, benefit renews and member can claim again
Webhook claim benefits
What they are: Automated integration with external services. System triggers webhook when member claims.
Best for:
Instant digital delivery (discount codes, content)
Automated NFT airdrops
Integration with merchandise platforms
High-volume, scalable fulfillment
Configuration:
Type: Webhook
Claim type: Claimable
Webhook URL: Endpoint that receives claim data
Custom payload values: Add your own data fields if needed
Renewable benefit: Toggle ON if claimable again after time period
Renewal period (in days): How long until benefit can be claimed again
Number of renewals: Total times benefit can be claimed (0 = infinite)
How it works:
Member clicks "Claim" button
System sends POST request to your webhook URL
Your service receives claim data (wallet address, email, etc.)
Your service processes and delivers benefit
Member receives benefit
Default webhook payload includes:
Wallet address of claimant
Badge information
Claim timestamp
Any custom values you added
Testing webhooks: Use a service like webhook.site to test your webhook configuration before going live. The admin panel includes a Test button to trigger sample webhooks.
Example workflow - Automated discount code:
Member claims discount benefit
Webhook triggers to your merchandise platform
Platform generates unique discount code
Platform emails code directly to member
Process happens instantly without admin involvement
Example workflow - NFT airdrop:
Member claims bonus NFT benefit
Webhook triggers to your minting service
Service airdrops NFT to member's wallet address
Member receives NFT automatically
Step 3: Configure renewable benefits (Optional)
Renewable benefits can be claimed multiple times after waiting periods.
Renewal settings
Renewal period (in days) How many days must pass before benefit can be claimed again.
Example: 365 days for annual merchandise claim
Example: 90 days for quarterly content drops
Number of renewals Total times benefit can be claimed.
Set to 0 for infinite renewals
Set to specific number to limit claims (e.g., "3" for three total claims)
Use cases:
Annual merchandise claim that renews yearly
Quarterly exclusive content access
Monthly discount codes
Seasonal rewards
Important: Renewable benefits only work with Claimable types (email or webhook). Static benefits are always active and don't use renewals.
Step 4: Attach benefit to badges
After creating a benefit, you must attach it to specific badges.
Attaching process
Navigate to Benefits in admin portal
Click Attach benefits button
Select the benefit you want to attach
See list of all available badges
Click Attach to badge for each badge that should include this benefit
Benefit is now attached
Managing attachments
Add to multiple badges: Attach the same benefit to as many badges as needed. One benefit can serve multiple tiers.
Remove from badges: Benefits can be detached at any time. Click the remove icon next to the badge name.
Important: Unlike badge properties, benefit attachments affect existing badges immediately. When you:
Attach a benefit: All existing badge holders receive it
Remove a benefit: All existing badge holders lose access
Edit benefit details: Changes apply to all attached badges
Best practices
Benefit design
✓ Start simple - Begin with 1-2 benefits per badge, add more later ✓ Mix types - Combine static and claimable for varied value ✓ Clear names - Use descriptive titles that explain the benefit ✓ Set expectations - Clearly communicate renewal periods and limitations
Email vs webhook
✓ Use Email for: Personal items, small batches, manual fulfillment ✓ Use Webhook for: Digital delivery, automation, high volume ✓ Test webhooks before going live with real claims ✓ Keep admin email monitored for claim notifications
Renewable benefits
✓ Communicate clearly - Tell holders when benefits renew ✓ Set reasonable periods - Don't make renewals too frequent or too rare ✓ Consider costs - Factor fulfillment costs into renewal frequency ✓ Track claims - Monitor benefit usage through admin dashboard
Benefit management
✓ Test before launch - Verify email notifications and webhooks work ✓ Document processes - Keep internal notes on fulfillment workflows ✓ Communicate changes - Tell community before removing benefits ✓ Add value over time - Consider adding new benefits to existing badges as rewards
Last updated