Domino Docs
Go to Domino
  • Introduction
  • Concepts
  • Getting started
  • Quest Management
    • Creating your community on Domino
    • Launching your first quest
    • Creating custom quest tasks
  • Viewing quest claims (submissions)
  • Using custom rewards
  • Understanding the task verification automation
  • Restricting quest access to Discord role
  • Domino Portal
    • Setting up the portal
    • Customizing the portal
    • Managing portal quests
    • Creating leaderboards
  • Developer Resources
    • Authenticating users with the portal API
    • Embedding the portal in Telegram Mini Apps
  • Checking claim status
  • Getting quest modules
  • Claiming a quest
Powered by GitBook
On this page
  • Overview
  • Understanding reward options
  • Platform-specific rewards
  • Custom reward automations
  • Setting up Discord role rewards
  • Connecting your Discord server
  • Adding a Discord role reward to a quest
  • Advanced reward configurations
  • Multiple reward automations
  • Other custom reward types
  • Token rewards
  • NFT rewards
  • Troubleshooting

Using custom rewards

Learn how to configure custom rewards for your quests in Domino, including Discord roles, tokens, NFTs and more.

PreviousViewing quest claims (submissions)NextUnderstanding the task verification automation

Last updated 12 days ago

Prerequisites

  • A Domino account with access to the Quests section

  • A quest created in Domino (see )

  • 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:

  1. Navigate to the Integrations section in your Domino dashboard

  2. Find and select the Discord integration

  3. Follow the authorization flow to connect your Discord server

  4. 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:

  1. Navigate to your quest in the editor

  2. Scroll to the Reward section

  3. Under Automations, click Add Automation

  4. 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

All configured reward automations will be executed when a user successfully completes a quest, regardless of the platform where the quest is hosted (Zealy or Domino portal).

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:

  1. Connect your token distribution wallet

  2. Configure token amounts and distribution methods

  3. Set gas fee parameters (if applicable)

NFT rewards

Grant exclusive NFTs to quest completers:

  1. Configure the NFT collection and specific NFT to grant

  2. Set distribution parameters (all users, limited quantity, etc.)

  3. 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

Other Reward Automation Issues

  • Wallet connection errors: For token rewards, ensure connected wallets have sufficient balance

  • Gas fee issues: For on-chain rewards, check gas fee settings and network conditions

  • Rate limiting: Some integrations have rate limits that can affect bulk reward distribution

Launching your first quest
Platform-specific reward options in the quest editor