# Task settings

Each task in claimr includes a set of general settings that help you define how users interact with your campaign. These settings stay the same for all tasks. However, depending on the specific task type, additional fields may appear to support the functionality of that task. You can always refer to each task type’s article for advanced configuration options.

## **General settings**

Set the basic parameters for your task in this section.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FhAmsF7NTgbLsq6jXOwyW%2FScreenshot%202024-07-15%20at%2012.41.53.png?alt=media&#x26;token=2afa2f06-72c0-4730-9aa0-0a7b0ead6984" alt="" width="375"><figcaption><p>Task General section</p></figcaption></figure>

### **Task name**

This is the internal name for the task, useful for organizing your tasks. It’s auto-filled based on your task type but you can edit it anytime.

### **Task header**

The main instruction or title visible to participants. Keep it short and action-oriented.

### **Task completion message**

A message users will see after successfully completing the task. Use this to thank them or offer a next step.

### **Task tags**

Use these tags within the task header and the task completion message to display information about the reward, provide personalized feedback, and acknowledge the user's achievement:

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FAAbyVsBz1N93LVLoGCOm%2FScreenshot%202024-10-30%20at%2020.55.06.png?alt=media&#x26;token=e0acdcc2-f791-40b8-a3ba-870d02bef413" alt="" width="563"><figcaption><p>Task header and task completion tags</p></figcaption></figure>

**`{points}`:** Displays the number of points.

**`{icon}`:** Displays the icon associated with the points in your campaign.

**`{xp}`:** Displays the name or label used for points in your campaign.

### Task failure message

A fallback message shown when users fail to complete the task. Keep it friendly and helpful.

### **Task description**

Add detailed instructions, examples, or links.&#x20;

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2F1aIfnTpsxDjDUNqGW4kz%2FScreenshot%202025-07-01%20at%2000.31.18.png?alt=media&#x26;token=d03d9515-00d3-45fb-bb0b-8949d303eaeb" alt="" width="375"><figcaption><p>Task description section</p></figcaption></figure>

Click the <mark style="color:green;">**+ Create description**</mark> and a text field will appear. Enter your description, select the style and the colour of your text, and add links or pictures. Once you're ready, click <mark style="color:green;">**Save**</mark> to save your changes. Use the <mark style="color:green;">**Preview**</mark> button (top right) to see how your referral task will look to participants.

For more details on descriptions and tags, visit our [descriptions-creation-usage-tags](https://claimr-io.gitbook.io/claimr-help-center/descriptions-creation-usage-tags "mention")article.

{% hint style="success" %}
Pro tip: Use the task description to highlight the benefits of referring friends, both for the referrer and the new participant. Clearly explain the rewards or incentives they can earn by successfully referring others.
{% 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**

1. **Insert the tag:** Simply type the tag directly into the text editor when creating or editing the task description.
2. **Save your changes:** Once you've added the tags, save your changes to the task description.
3. **View the result:** When a user views the task, the tags will be dynamically replaced with the corresponding information.

Too see all available tags, visit our [descriptions-creation-usage-tags](https://claimr-io.gitbook.io/claimr-help-center/descriptions-creation-usage-tags "mention")article.

{% hint style="warning" %}
Make sure all tags are correctly formatted so they are recognized and processed by claimr.
{% endhint %}

### **Collapse description**

Control the visibility of your campaign description for potential participants.

* The toggle is off: The full description will be visible to anyone viewing your campaign.
* The toggle is on: The description will be condensed, showing only a brief summary. Participants will need to click "Show more" to expand and read the full description.

This is a great way to keep your campaign page looking clean and uncluttered, while still giving interested users the option to learn more about your campaign.

## **Task type**

Choose the type of task you want to create for your quest. Each task type has its own unique set of settings and configurations.&#x20;

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FEBJmTEx8aaeHVdMvmZsJ%2FScreenshot%202024-08-03%20at%2002.06.49.png?alt=media&#x26;token=0a2d4adb-fa47-4585-aa2a-74687b94693d" alt="" width="375"><figcaption><p>Task type section</p></figcaption></figure>

* **Social Media:** Task designed for social media platforms X (Twitter), Discord, Facebook, Instagram, YouTube, Reddit, LinkedIn, Telegram.
* **Forms:** Completing online forms or surveys.
* **Web:** Visiting specific web pages or performing actions on websites.
* **Web3:** Interacting with blockchain-based applications or wallets.
* **Anti-Bot:** Tasks designed to differentiate between human users and bots.
* **User-Generated Content:** Creating and submitting content like images, videos, or text.
* **Proof of Work:** Completing tasks that require effort or skill.
* **Common:** General tasks that don't fit into other categories.
* **API:** Tasks integrated with external APIs.

The instructions on how to set up and customize each task type can be found in the corresponding articles. Select the task type you want to learn more about, and you'll be guided through the process step-by-step.

## Task rewards

Define how users earn points and rewards

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FMZqE1GYXGE9wRPnlLxJI%2FScreenshot%202024-07-05%20at%2015.51.41.png?alt=media&#x26;token=8c34fa3c-9828-43e0-94df-fdb0dc840435" alt="" width="375"><figcaption><p>Task rewards section</p></figcaption></figure>

* **Completion points**: The base reward given when a user successfully completes the task.
* **Points multiplier (%)**: Boost rewards by a set percentage. Use this for promotions or to highlight priority tasks.
* **Referral completion points** (for referral-based tasks only): Bonus points awarded to the user who referred someone that completes the task.

{% hint style="success" %}
**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 %}

Click <mark style="color:green;">**Create reward**</mark> to set up a custom reward. You’ll be able to:

* Name your reward
* Upload an image
* Choose reward type (e.g., Web3 token, gift code, etc.)
* Configure network or value if needed

For full instructions, check out our [rewards](https://claimr-io.gitbook.io/claimr-help-center/rewards "mention") articles.&#x20;

## Completion pop-up&#x20;

Keep your users informed by customizing a pop-up message they see immediately after completing a task. Use it to reinforce achievement, give next steps, or drive further engagement.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FWwjryTmxo4qnr6CBVcU1%2FScreenshot%202025-06-29%20at%2021.46.06.png?alt=media&#x26;token=64b184ad-7391-4899-b136-855211010b89" alt="" width="375"><figcaption></figcaption></figure>

To set it up:

1. Toggle <mark style="color:green;">**Enable completion pop-up**</mark><mark style="color:green;">.</mark>
2. Click <mark style="color:green;">**Create**</mark><mark style="color:green;">.</mark> This opens a rich-text editor.
3. Add your message — include visuals, formatting, links, or call-to-action content.
4. Click <mark style="color:green;">**Save**</mark>.
5. Add an **animation visual** **effect** to make the pop-up more engaging.

## **Dependencies**

Control the flow of your campaign by specifying which quests unlock after others. Create a strategic path for your users to follow.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FaFdCEtqLlAuHEUKFtko2%2FScreenshot%202024-07-05%20at%2015.53.37.png?alt=media&#x26;token=30a391af-77dd-44d7-8e10-6c3dc01459b8" alt="" width="375"><figcaption><p>Task dependencies section</p></figcaption></figure>

* **Open after tasks**: Specify which tasks must be completed before this one becomes accessible.
* **Set as optional**: Decide if those prerequisite tasks are mandatory or not.

## Advanced settings

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FwXyB7BZCkxstxpP9rnuH%2FScreenshot%202024-07-05%20at%2015.56.42.png?alt=media&#x26;token=d4355a55-87ce-40f6-8f29-f5215a395be8" alt="" width="375"><figcaption><p>Advanced settings</p></figcaption></figure>

Add metadata to your referral task, such as internal notes, tracking information, or any other relevant details that aren't visible to participants.

## **Save and preview**

After you've configured all sections of your task, click <mark style="color:green;">**Save Changes**</mark> to apply your changes. If you don't want to save your changes, click <mark style="background-color:yellow;">**Close**</mark>.&#x20;

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2F5bnYHBuYJDg4g8BWOnMu%2FScreenshot%202024-08-03%20at%2002.23.03.png?alt=media&#x26;token=42a72fb2-adef-4942-8873-c5b44bd8cfc4" alt="" width="375"><figcaption><p>Preview mode</p></figcaption></figure>

To see how your task will appear to users, click <mark style="color:green;">**Preview**</mark>. This will open a new tab showcasing three different views: desktop, tablet, and mobile. Toggle between them to ensure your task looks and functions seamlessly across all devices.
