Task settings

Each task includes settings that control its behavior, appearance, and rewards. While some settings are universal across all tasks, each task type has unique configuration options based on its specific functionality.

​

Before you start

Make sure you have:

• A task created within your quest
• A clear understanding of what action you want users to complete
• Your reward structure planned

​

Access task settings

​

Task info

View your task’s basic identification details at the top of the settings panel. ID: Your task’s unique identifier. Click the copy icon to copy it to your clipboard for API integrations or tracking purposes. Name: The internal name of your task. This auto-fills based on your task type but you can edit it anytime for better organization.

​

Task settings

Configure the specific behavior for this task type. These settings vary depending on which task you created. For detailed configuration options specific to each task type, visit the corresponding task article.

​

General settings

Configure how your task appears and communicates with users. Click the + icons to expand each option.

​

Task header

Click + Task header to add the main instruction users see for this task. Enter short, action-oriented text that clearly tells users what to do. Keep it concise and direct. Task header tags Use these tags within the task header to display reward information:

• {points}: Displays the number of points users will earn
• {icon}: Displays the icon associated with points in your campaign
• {xp}: Displays the name or label used for points in your campaign (e.g., “XP”, “Tokens”)

Example: “Complete this task to earn {points} {xp}” Click the trash icon to remove the task header.

​

Task completion message

Click + Task completion message to add the message users see after successfully completing the task. Enter text that acknowledges their achievement and encourages next steps. Use the same tags available in task headers: {points}, {icon}, {xp} Click the trash icon to remove the completion message.

​

Task failure message

Click + Task failure message to add a message shown when users fail to complete the task. Enter friendly, helpful text that guides users to try again. Click the trash icon to remove the failure message.

​

Description

Click + Description to open a rich text editor where you create detailed task instructions. Add detailed instructions, examples, or links to help users complete the task successfully.

1. Click + Description to open the text editor
2. Enter your description using the formatting tools
3. Select text style and color
4. Add links or images as needed
5. Click Save when finished

Task description: The main content area where you write your instructions. Edit: Click to modify the description content. Animation type: Select from the dropdown to choose how the description appears.

• “typing” displays the text with a typing animation effect
• “none” shows the description immediately

Collapse description: Toggle this on to condense the description initially.

• Toggle off: Full description is visible immediately
• Toggle on: Description shows condensed with a “Show more” option

This keeps your task card clean while giving interested users access to full details.

​

Task description tags

Personalize your task descriptions and dynamically display information relevant to each user, making the task experience more engaging and tailored. How to use tags Insert the tag directly into the text editor when creating or editing the task description. Simply type the tag (e.g., {user.name} or {user.points}). Save your changes to the task description. When a user views the task, the tags automatically replace with the corresponding information specific to that user. To see all available tags, visit the Descriptions: creation, usage, tags article. Make sure all tags are correctly formatted so they are recognized and processed by Claimr.

​

Task banner

Click + Task banner to upload a visual image for your task card. Upload an eye-catching image that represents your task or campaign theme.

• Click the image thumbnail to edit or replace
• Click the trash icon to remove the banner
• Use high-quality images that match your brand

​

Task rewards

Define how users earn points and rewards for completing this task. Click + to expand the Task rewards section.

​

Points

Enter the base reward given when a user successfully completes the task. Consider the effort required. Align with your campaign’s point economy.

​

Points multiplier

Click + Points multiplier to add a percentage boost to the base reward. Enter a percentage value to increase the points. Example: 100 points with 5% multiplier = 105 total points.

​

Referral points

Click + Referral Points to set bonus points for users who referred someone that completes this task. Enter the number of points awarded to the referrer when their invitee completes this task. Encourage users to share your campaign and reward community growth.

​

Rewards

Click + Rewards to set up custom rewards beyond points. Click + Create to open the reward creation dialog where you can:

• Name your reward
• Upload an image
• Choose reward type (Web3 token, Discord role, gift code, etc.)
• Configure network or value as needed

For complete instructions on creating and configuring rewards, check out the Rewards article.

​

Completion pop-up

Show users a custom message immediately after they complete your task. Click + to expand the Completion pop-up section. Enable completion pop-up: Toggle this on to activate the completion message. Pop-up configuration: View and edit the message users see after completing the task. Add your message with visuals, formatting, links, or call-to-action content. Click Save when finished. Animation type: Select how the pop-up appears from the dropdown menu.

​

Dependencies

Control the flow of your campaign by specifying which tasks must be completed before this one becomes accessible. Click + to expand the Dependencies section. Open after tasks: Select which tasks users must complete before accessing this task. Selected tasks appear as tags (e.g., “Watch a video”). Click the x to remove a dependency. Is optional: Toggle this on to make the prerequisite tasks optional rather than mandatory.

• Toggle off: Users must complete all prerequisite tasks
• Toggle on: Users can skip prerequisites

​

Advanced settings

Add internal metadata and tracking information not visible to users. Click + to expand the Advanced settings section. Use it for internal notes, tracking information, or reference IDs. Add any relevant details for your team’s use. This information isn’t shown to participants.

​

Save and preview

After configuring your task settings: Save changes: Click the green Save changes button at the bottom to apply all your configurations. Close: Click Close to exit without saving changes. Preview: Click Preview to see how your task appears to users.

• Opens in a new tab
• Shows desktop, tablet, and mobile views
• Toggle between device types to ensure your task looks and functions seamlessly across all devices

​

What to do next

Now that your task is configured:

1. Test your task — Complete it yourself to verify everything works
2. Add more tasks — Build out your complete quest journey
3. Monitor performance in the Data analytics section — Track completion rates and user engagement