Quest settings
Configure every aspect of your quest to create engaging experiences that align with your campaign goals.
Before you start
Make sure you have:
A quest already created in your campaign
A clear understanding of what you want users to accomplish
Your reward structure planned out
Access quest settings
1. Navigate to Quests
In your Claimr panel, click Quests in the campaign header menu. You'll see all quest groups you've created.
2. Select your quest
Find the quest you want to configure and click on it. The quest settings page will open.
Quest settings overview
The settings page is organized into collapsible sections. General settings is expanded by default, while other sections start collapsed. Click the + icon next to any section to expand it and configure those settings.
General settings
This section contains the core identity and presentation elements of your quest.
Quest ID Your quest's unique identifier. Click the copy icon to copy it to your clipboard. Use this ID for API integrations or technical tracking.
Name The public-facing title of your quest. Click the name to edit it directly. Make it catchy and memorable. Keep it concise (2-5 words works best)
Quest image The main visual for your quest card. Choose images that represent your quest's theme.
Click the image thumbnail to edit or replace it
Click the trash icon to remove the current image
Short description A brief summary that appears on the quest card.
Click the text to edit it directly
Explain what users will do and what they'll earn
Keep it under 2 sentences
Click the trash icon to remove it
Description
Add a full description that explains your quest's goals, rewards, and what users should expect.
Click + Description
The text editor opens with formatting options
Write your description using the formatting tools
Add links, images, or styled text as needed
Quest description tags
Personalize your quest descriptions and dynamically display information relevant to each user, making the quest experience more engaging and tailored.
Insert the tag: Simply type the tag directly into the text editor when creating or editing the quest description.
Save your changes: Once you've added the tags, save your changes to the quest description.
View the result: When a user views the quest, the tags will be dynamically replaced with the corresponding information.
To find more information about tags, visit our article Descriptions: creation, usage, tags
Animation
Customize the visual presentation of your description using the Animation type setting.
Select typing from the available animation types. When selected, the description displays with a typing animation in the widget.
Collapse description
Control the initial visibility of your quest description. Use this to keep your quest page clean and uncluttered while still giving interested users the option to learn more.
Toggle off: The full description is visible to anyone viewing your quest.
Toggle on: The description is condensed, showing only a brief summary. Participants need to click Show more to expand and read the full description.
Background image
Use Background image to add a backdrop for your quest card.
Click + Background image
Select Upload to choose an image from your computer
The image appears behind your quest content, adding visual depth
Rewards
Define the points, multipliers, and special rewards users earn for completing this quest.
Points: Enter the base number of points users earn for completing this quest.
Consider the effort required and your campaign's point economy
The field shows the current value
Points multiplier (%): Enter a percentage to add a bonus to the base points.
Example: 100 points with 5% multiplier = 105 total points
Use this to highlight important quests or run promotions
Click the trash icon to remove the multiplier
Rewards: Click + Create to open the reward creation dialog and define special rewards beyond points.
Pro tip: Balance your reward structure to ensure it's both motivating and sustainable for your campaign. Too few points might not incentivize participation, while too many could deplete your reward pool quickly.
Create a reward
When you click + Create, a form opens with these sections:
General
Short name: Enter an internal name for your reference (e.g., "Reward name").
Description: Explain what this reward is and why users want it.
Image: Click Upload image to add a visual representation of your reward.
Type
Select the reward type by clicking one of these buttons:
Web3 Token - Cryptocurrency or token rewards
Discord Role - Grant Discord server roles
Resource - Custom resource or asset
Virtual Asset - In-game or virtual items
Invite Codes - Access codes users can share
Gift Codes - Redeemable gift codes
Scripted - Custom scripted rewards
Points - Additional point rewards
Badge - Achievement badges
Puzzle Piece - Collectible puzzle elements
General configuration
Configuration options vary depending on the reward type you select. For detailed information about each reward type and its specific settings, visit our Rewards article.
Quest card details
Customize how your quest appears in the campaign widget.
Labels: Add tags that help categorize or filter this quest.
Click Select tag to choose from existing tags
Click the x to remove a tag
Quest card details
Select the display style for your quest card from the dropdown menu: daily or default styles. This affects the visual presentation in your widget
Progressbar UI
Select how progress displays from the dropdown menu: default or segment.
Button text customization
Customize the text that appears on quest buttons in different states. Click each button option to expand and edit. Click the trash icon to reset to default.
Start button: Edit the text shown when users first see the quest.
Continue button: Edit the text shown when users are in progress.
Completed button: Edit the text shown when the quest is finished.
Locked button: Edit the text shown when the quest isn't accessible yet.
Pro tip: Use clear and concise button text that accurately reflects the action it triggers. This helps users understand the quest flow and avoid confusion.
Quest rules
Control when, how, and who can participate in your quest.
Pro tip: Set clear time limits to create a sense of urgency and drive more engagement. Announce the time limit in your quest description and use reminders to encourage participation before the deadline.
Limit quest time
Toggle this on to set start and end dates for your quest availability.
Start at: Click the calendar icon to select when the quest becomes available. Users can't access the quest before this time. Click the x to clear the date.
End at: Click the calendar icon to select when the quest closes. Users can't start or continue after this time. Click the x to clear the date.
Additional options
Click the + icon to expand these options
Start quest without login: Toggle this on to allow users to view and interact with the quest without logging in. Useful for preview or demo quests.
Dependencies: Set prerequisites users must complete before accessing this quest. Click to open the dependencies selector.
Max participants: Enter a number to limit how many users can complete this quest. Quest locks automatically when the limit is reached. Great for exclusive or limited-time rewards
Completion pop-up
Show users a custom message when they finish your quest.
Enable completion pop-up: Toggle this on to activate the completion message.
Pop-up configuration
View and edit the message users see when completing the quest. Default text appears in the preview box. Use formatting, emojis, or links to make it engaging
Animation type: Select how the pop-up text appears from the dropdown menu.
Pro tip: Use the completion pop-up to celebrate user achievements, guide them to the next quest, or promote special rewards they've unlocked.
Advanced settings
Manage visibility, metadata, and additional display rules for your quest.
Hide quest toggle
Hide the quest from users while you're still configuring it or testing some tasks. Quest won't appear in the campaign widget.
Tags
Enter a tag name in the field (e.g., new_users, beta_testers, europe_only). To add multiple tags, separate them with commas. To remove a tag, click the 'x' next to its name.
Organize and segment: Use tags for internal categorization or to target content delivery (e.g., show this quest only to users who match the new_users tag passed in the script).
Create phased experiences: Unlock this quest progressively for users who acquire certain tags.
A/B test content: Direct different user segments to alternatively tagged quests.
Manage access: Restrict or grant access to this quest based on user tags.
Meta
Add internal notes or tracking information not visible to users.
Click in the "Type here" field to enter metadata. Use this for internal organization, notes, or reference IDs. This data is for your team's use only. Click the trash icon to clear the field.
Visible for
Show this quest only to specific users by entering their wallet addresses or eIDs.
Enter wallet addresses or eIDs in the "Type here" field, separated by commas. When you add users to this list, only those specific users will see this quest in your campaign. Leave this field empty to show the quest to everyone.
Click the trash icon to clear the field and make the quest visible to all users again.
Attributes
Add custom data attributes to enable advanced styling and unique customization for this specific quest.
Enter custom attribute keys and values that your developer can use to apply unique CSS styling to this quest. This allows you to make individual quests look different from others in your campaign without affecting the rest.
Click the edit icon to modify or the trash icon to remove attributes.
Quest actions
Manage your quest with these options available at the bottom of the settings page.
Delete: Click the trash icon to permanently remove this quest from your campaign. A confirmation prompt appears to prevent accidental deletions. This action cannot be undone. All quest data and user progress will be lost.
Archive: Click the download icon to archive your quest configuration. Save quest settings for future reference. Useful for backing up quest data before major changes.
Clone: Click the copy icon to create a clone of this quest. The copy appears in the same quest group. Useful for creating similar quests quickly or testing variations
Pro tip: Duplicate your quest before making major changes. This gives you a backup version in case you want to revert or compare different configurations.
Saving your settings
After you've configured all sections of your quest, all changes save automatically as you make them.
Review all sections to ensure everything is correct, then test your quest in the widget to verify it works as expected.
Pro tip: After setting up your quest, preview it in your campaign widget to see how users will experience it. Make adjustments based on how it looks and flows.
What to do next
Now that your quest is configured:
Add tasks - Create the specific actions users will complete within this quest
Monitor performance in data analytics - Track how users engage with your quest
Last updated
Was this helpful?