> 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/create-new-task.md). # Create new task Tasks are what bring your quest to life. They guide users to take specific actions, like joining a Telegram channel, submitting a video, or connecting their wallet, and reward them for completing each step. In Claimr, you can choose from a wide range of task types across multiple platforms. Whether you’re building a social campaign or collecting Web3 data, creating a task is quick and flexible. ## Open your quest From your campaign dashboard, go to the **Quests tab** and click on the quest you’d like to work on. This opens the quest’s settings page.

## Create a new task On the quest settings page, click the **+ Create new task** button. This opens the task builder where you'll configure your task. ## Select the task's category and type Start by selecting a task category: Telegram, Web3, Events, etc. Each category includes one or more task types that define what the user needs to do.

After you select the task type: * A task name will be filled in automatically based on the type you chose. * You can edit the name if you’d like. Once you're ready, click **Continue** to move to the setup. ## Configure basic settings Now you’ll set up the core settings for your task.

All tasks include: * Completion Points: How many points a user earns for completing this task. * Points multiplier (%): Optional bonus to boost the base reward. * Recurrence: Choose whether the task can be completed once, daily, weekly, or multiple times. Additional settings may appear depending on the task type you selected in step 3. For example, social tasks may ask for a post link. ## Finalize your task At this point, you have two options: * Click **Create task** to save and add it to your quest right away. You’ll now see the task listed in your quest. From there, you can reorder it, delete it, or edit it anytime. * Or, click **Advanced settings** to continue configuring more options specific to the selected task type. ## Advanced settings Advanced settings allow you to refine how your task looks, behaves, and connects to other tasks.

### **Task header** The main instruction or call-to-action visible to users. Keep it clear and actionable. ### **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: * **`{points}`:** Displays the number of points the user earned for completing the task. * **`{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.

Click the **+ Create description** 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 **Save** to save your changes. Use the **Preview** button (top right) to see how your referral task will look to participants. {% 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. **Available tags:** **`{{ref_name}}`:** Displays the name of the user who referred the current user to the campaign (if applicable). This can be useful for creating personalized welcome messages or acknowledging referrals. **`{{team_name}}`:** Shows the name of the team the user belongs to. This tag can be used to foster a sense of community and encourage team participation. **`{{total_xp}}`:** Displays the user's total accumulated experience points (XP) within the campaign. This tag can be used to show users their overall progress and motivate them to earn more points. **`{{xp_alias}}`:** Shows the name or label used for XP in your campaign. This allows you to customize the terminology to match your campaign's theme or branding. **`{{participants}}`:** Displays the total number of participants in the campaign. This tag can create a sense of community and encourage friendly competition. **`{{evm_address}}`:** Shows the user's connected EVM (Ethereum Virtual Machine) compatible wallet address, if available. This can be useful for displaying personalized information related to the user's wallet or blockchain activity. {% 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. ### Completion pop-up 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.

To set it up: 1. Toggle **Enable completion pop-up**. 2. Click **Create**. This opens a rich-text editor. 3. Add your message — include visuals, formatting, links, or call-to-action content. 4. Click **Save**. 5. Add an **animation visual** **effect** to make the pop-up more engaging. ### Referral completion points Set how many points a user earns if someone they referred completes this task. ### Dependencies Control when a task becomes available. Use checkboxes to link prerequisite tasks. {% hint style="info" %} For detailed information about each setting and tag, read [Task settings](/tasks/task-settings.md) {% endhint %} Once you're done configuring all fields, click **Create task** to save it and return to your quest overview. You can edit, delete, or reorder tasks anytime from the **Quest page.** --- # 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/create-new-task.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.