Using custom rewards
Learn how to configure custom rewards for your quests in Domino, including Discord roles, tokens, NFTs and more.
Prerequisites
A Domino account with access to the Quests section
A quest created in Domino (see Launching your first quest)
For Discord role rewards: Admin access to your community's Discord server and a connected Discord integration
Overview
While Domino offers standard rewards like XP (for Zealy) and leaderboard points (for Domino portal), the platform's true power lies in its ability to deliver custom rewards through automations. This guide explains how to enhance your community quests with meaningful rewards like Discord roles, tokens, NFTs, and more.
Understanding reward options
Domino's flexible reward system allows you to configure multiple types of rewards for quest completion.
Platform-specific rewards
Depending on your chosen platform, Domino automatically provides these standard reward options:
Zealy platform: Award XP to users who complete quests
Domino portal: Award points to specific leaderboards
Platform Flexibility
The same quest can be deployed to either Zealy or Domino portal with platform-appropriate rewards. This allows you to reuse quest designs across different community hubs.
Custom reward automations
Beyond platform-specific rewards, Domino allows you to add any number of custom reward automations. These automations run automatically when a user completes a quest, regardless of the platform where the quest is hosted.
Setting up Discord role rewards
One of the most popular custom rewards is granting Discord roles to users who complete specific quests. Here's how to set it up:
Connecting your Discord server
Before you can offer Discord role rewards, you need to connect your Discord server to Domino:
Navigate to the Integrations section in your Domino dashboard
Find and select the Discord integration
Follow the authorization flow to connect your Discord server
Grant the necessary permissions for role management
Ensure the Domino bot has sufficient permissions in your Discord server. It needs the "Manage Roles" permission, and its role must be positioned higher in the hierarchy than any roles you want to assign.
Adding a Discord role reward to a quest
Once your Discord integration is set up:
Navigate to your quest in the editor
Scroll to the Reward section
Under Automations, click Add Automation
Select Discord Role from the automation options
Expected Outcome
When users complete the quest, they will automatically receive the configured Discord role in your server. The user will see a success message confirming the reward was granted.
Advanced reward configurations
Domino's automation system offers several advanced options for customizing how rewards are distributed.
Multiple reward automations
You can add any number of reward automations to a single quest. This allows you to:
Offer tiered rewards (e.g., everyone gets a Discord role, but only the first 10 get an NFT)
Provide rewards across different platforms (e.g., Discord role + tokens)
Create comprehensive reward packages for high-value quests
Other custom reward types
Beyond Discord roles, Domino supports various other custom rewards through its automation system:
Token rewards
Reward users with ERC-20 tokens when they complete quests:
Connect your token distribution wallet
Configure token amounts and distribution methods
Set gas fee parameters (if applicable)
NFT rewards
Grant exclusive NFTs to quest completers:
Configure the NFT collection and specific NFT to grant
Set distribution parameters (all users, limited quantity, etc.)
Configure transaction parameters
Troubleshooting
If you encounter issues with reward distribution, check these common areas:
Common Discord Role Reward Issues
Permission errors: Ensure the Domino bot has "Manage Roles" permission
Role hierarchy: The Domino bot's role must be positioned higher than the roles it's assigning
User not in server: Users must join your Discord server before completing the quest
Disconnected integration: Check that your Discord integration is still active
Last updated