Creating custom quest tasks

Learn how to create custom validation tasks for your quests when built-in options don't meet your needs.

Prerequisites

• You need a Domino account with access to the Quests section

• Basic understanding of Domino's automation system

• An idea of what specific task validation you want to implement

Overview

While Domino offers many built-in task types, your community might need specialized validation logic. Custom quest tasks let you define exactly how submissions are verified, giving you complete control over the user experience and validation criteria.

Understanding Task Types in Domino

Domino's quest system supports different types of tasks to engage your community.

Built-in Tasks

These are pre-configured tasks with standard validation:

• Submit URL

• Submit Text

• Upload File

• Tweet/Retweet/Reply

• Quiz

• Visit Link

• And more

Built-in tasks provide quick setup for common community activities

Task Templates

These are reusable tasks published to the task library, usually built on top of built-in tasks with custom validation logic.

Custom Tasks

When you need specific validation logic not covered by existing options, custom tasks give you complete control using Domino's automation system.

Custom tasks are perfect for:

• Verifying complex user actions across multiple platforms

• Creating unique interactive experiences

• Implementing community-specific validation rules

• Building verification logic that spans multiple steps

Creating Your First Custom Task

Adding a Custom Task to Your Quest

1. In your quest setup page, click Add Task

2. Select Custom from the task options

3. Give your task a descriptive name and add instructions in the description field

Supademo

Setting Up Task Validation

Every custom task requires a validation automation that determines whether a user has successfully completed the task.

1. Navigate to the Validation tab in your task configuration

2. Click Create new to set up a validation automation

Building the Validation Automation

Automation Structure Requirements

A valid task automation must include:

• A Task Submitted trigger that activates when a user attempts the task

• A flow that evaluates the user's submission

• A Task Completed action for successful validation

• A Task Failed action for unsuccessful validation

Your automation must include both "Task Completed" and "Task Failed" actions, or users might get stuck when their submission doesn't meet your criteria.

Designing the Validation Logic

1. In the automation editor, start with the pre-configured Task Submitted trigger

2. Add conditions to evaluate the user's submission

3. Connect the conditions to either "Task Completed" or "Task Failed" endpoints

Crafting Conditional Logic

Use the conditional step to determine if the task should be marked as complete:

1. Click on the Set the task condition step

2. Configure your validation rules based on user input or external data

3. Make sure successful paths lead to "Task Completed" and failed paths to "Task Failed"

The automation receives all user input from the task UI. Access these inputs using variables in your conditions.

Supademo

Configuring User Requirements

Required Accounts & Wallets

You can specify what connected accounts users need to complete your task:

1. Navigate to the User identification tab

2. Select which social accounts users need (Twitter, Discord, etc.)

3. Choose any wallet requirements for blockchain-related tasks

Configure which connected accounts users need to complete your task

Advanced Configuration

Custom Input Fields

If your task requires user input beyond the built-in options:

1. Base your custom task on an appropriate built-in task (e.g., "Submit Text" for text input)

2. Configure the input fields in the Config tab

3. Access these inputs in your validation automation

Custom Success Messages

Configure what users see when they complete the task:

1. In your validation automation, use the Task Completed action

2. Add a custom success message in the "reason" field

3. Enable "Use success message as claim success message" to display this to users

Creating Reusable Task Templates

Once you've created a useful custom task, you can convert it to a template for reuse across multiple quests.

Converting a Task to a Template

1. Click the three dots menu (⋮) on your task card

2. Select Create task template

3. Confirm the conversion

Task templates can be reused across quests and optionally published to the Domino task library for anyone to use.

Testing Custom Tasks

Before publishing your quest:

1. Save your quest as a draft

2. Use the preview feature to test the task from a user's perspective

3. Verify that your automation correctly validates both successful and failed attempts

Troubleshooting

Common Custom Task Issues

• Stuck in processing: Make sure your automation has both "Task Completed" and "Task Failed" endpoints

• Validation not working: Check that your conditional logic correctly evaluates user submissions

• Missing user input: Ensure you've configured appropriate input fields in the Config tab

Debugging Custom Task Automations

If your task validation isn't working as expected:

1. Test your automation directly in the automation editor

2. Check the automation runs for failed validations to understand what's happening

3. Verify that all connections between steps are correctly configured