> For the complete documentation index, see [llms.txt](https://docs.claimr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.claimr.io/tasks/task-settings.md).
# 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
#### 1. Navigate to your quest
From your campaign dashboard, go to the **Quests** tab and click on the quest containing the task you want to configure.
#### 2. Find your task
Locate the task in your quest's task list.
You'll see several action options:
**Edit**: Open the task settings panel (click this to configure your task)
**View**: Preview how the task appears to users
**Copy**: Duplicate the task with all its settings
**Delete**: Remove the task from your quest
#### 3. Open task settings
Click **Edit** to open the task settings panel. The panel opens with task-specific settings visible and other sections collapsed.
### 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.
{% hint style="info" %}
**Pro tip**: Use the task description to highlight benefits, provide clear examples, and include any helpful resources. The clearer your instructions, the higher your completion rate.
{% endhint %}
#### **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 our [Descriptions: creation, usage, tags](/descriptions-creation-usage-tags.md) 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.
{% hint style="info" %}
**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.
{% endhint %}
#### **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 our [Rewards ](/rewards.md)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.
{% hint style="info" %}
**Pro tip**: Use the completion pop-up to reinforce achievement, celebrate user success, give next steps, or drive further engagement.
{% endhint %}
### 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
{% hint style="info" %}
**Pro tip**: Create a strategic path for users to follow by chaining tasks together. This builds engagement progressively and ensures users don't skip important steps.
{% endhint %}
### 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** [**Data analytics**](/data-analytics.md) **section** - Track completion rates and user engagement
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.claimr.io/tasks/task-settings.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.