Skip to main content

​
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.
Quest settings overview

​
General settings

This section contains the core identity and presentation elements of your quest.
Quest general settings
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.
  1. Click + Description
  2. The text editor opens with formatting options
  3. Write your description using the formatting tools
  4. 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.
  1. Insert the tag: Simply type the tag directly into the text editor when creating or editing the quest description.
  2. Save your changes: Once you’ve added the tags, save your changes to the quest description.
  3. 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 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.
  1. Click + Background image
  2. Select Upload to choose an image from your computer
  3. The image appears behind your quest content, adding visual depth

​
Rewards

Define the points, multipliers, and special rewards users earn for completing this quest.
Quest rewards section
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.
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

Create a reward form
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 Rewards.

​
Quest card details

Customize how your quest appears in the campaign widget.
Quest card details section
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

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.
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.
Quest rules section
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.
Limit quest time detail
  • 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. The 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.
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 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.
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.
Quest advanced settings
Hide quest toggle: Hide the quest from users while you’re still configuring it or testing some tasks. The 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.
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.
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:
  1. Add tasks — Create the specific actions users will complete within this quest
  2. Monitor performance in Data analytics — Track how users engage with your quest