Challenges

Challenges are community events in which players compete and earn prizes by completing a group of related tasks (e.g., "Get Fit Challenge", "Stop Smoking"). Challenges can be found under the Social tab (direct link).

Challenges can be site-wide (under the Tavern group) or exclusive to a guild or party. Party-exclusive challenges are not available to non-party members.

Anyone can create or join a challenge in the Tavern, their parties, and/or the guilds to which they belong. Players can create any type of challenge consisting of whatever tasks best suit their needs. The creator decides when the challenge ends, and must choose a winner upon closing the challenge.

Obvious uses
 * Public competitions
 * Topical guild competitions (reading, writing, health, etc.)

Less obvious uses
 * Syllabus of homework and reading assignments for classrooms
 * Progress-monitoring by leaders of local groups
 * Addiction cessation groups



Finding and Browsing Challenges
Challenges are located under the Social tab, located in the top left corner of the website, beside the User and Inventory tabs. Clicking on "Challenges" will bring up a list of challenges that you can participate in (see image below).

The challenges are ordered from newest-oldest, to offer exposure for newly-created challenges. The only exception to this rule are Official Habitica Challenges, which stick to the top of the list, marked with the "Official Challenge" tag. These challenges are designated by a staff member.

Filtering Challenges
When you are on the Challenges tab, note the grey box to the left hand side of the list of challenges titled "Filter". The filter box allows you to sort the list in three ways.
 * To see challenges specific to the Tavern, one of your guilds, or your party, select the desired group under the "Groups" filter.
 * Use the "Membership" filter to view all your current challenges, or to find a new challenge you haven't yet joined.
 * The "Ownership" filter will let you display the challenges that you have created or those of which you are not the owner.

The first filter heading is "Groups". Click the "All" button to see all of the available challenges. The Tavern box will be automatically checked. Additionally, the party and guild(s) that you belong to will be listed under "Groups". You can to filter to challenges that are available for a particular group (i.e., the Tavern, meaning the challenge is open to all, or a guild or party, meaning the challenge is only available to members). If a check box is ticked next to a party or guild name, then the challenges from that party or guild will be displayed. If all check boxes are ticked, then the challenges from all those parties and guilds will be displayed, in addition to the Tavern challenges. By clicking "All", you will select all the boxes under Groups, whereby clicking "None" will deselect (or un-tick) all the boxes.

The next heading is "Membership". This section allows you to filter to only the challenges that you are participating in, not participating in, or both. Hence, if you select "Participating", then the list of challenges would only show those challenges that you have already joined. If you have not joined any challenges, you will not see anything listed when "Participating" is selected.

The "Groups" and "Membership" filters work in conjunction with each other. Therefore, if you only want to see Tavern challenges that you have not joined yet, then you would un-tick all other boxes under "Groups" except for "Tavern" and tick the "Not Participating" box under "Membership."

The third filter is "Ownership". This section allows you to see only those challenges that you have created, or only challenges that you have not created. It also works with the other two filters to further refine your search.

Viewing Challenge Details
To see more information about individual challenges, click on the challenge title link. Details about the challenge will appear, including the challenge description; the Habits, Dailies, To-Dos, and Rewards involved; and the Habitica members that have already joined the challenge (under the "How's Everyone Doing?" section).

To collapse the displayed challenge details, click on any challenge title.

Participant Progress
Clicking on a member's username in the "How's Everyone Doing?" section brings up a pop-up box that shows the member's progress on challenge tasks only. None of their personal tasks outside of the challenge will be displayed. In the image to the right, the "Say Hello in Tavern" Daily is greyed out, which means that this member has completed that task.

Note the difference in color of the user-specific tasks in comparison to the main challenge join page. The more orange color of the To-Dos indicates that this member has not completed these tasks for a long time.

This pop-up box can be closed by clicking the grey "x" in the upper right hand corner.

Contacting a Participant
You can contact a challenge participant by clicking on one of the three boxes in the bottom left hand corner of the pop-up box that appears after you click their username.
 * The headshot button will show your their profile, which shows stats and achievements.
 * The email button will let you send them a private message.
 * The giftbox icon will let you send them a gift. This could be useful in the case of a tie, as the challenge creator might like to award additional gems to a participant other than the challenge winner.

Joining and Participating in Challenges
If you decide to join a challenge, click the green "Join" button. The Habits, Dailies, To-Dos, and Rewards of that challenge will be automatically added to your own lists.

Should you accidentally join a challenge, or wish to leave the challenge, return to the challenges page and click the red "Leave" button that has replaced the "Join" button.

Challenge tasks will have a megaphone icon in the upper right corner to distinguish them from your personal tasks, and will be flagged with a specific tag as defined by the creator of the challenge (see challenge tags below).

To participate in the challenges that you have joined, all you have to do is complete the tasks with the megaphone icon.

Editing User Tasks
If a challenge requires participants to add extra notes or checklist items to a task, each participant must edit those tasks in their own Tasks tab. Any edits made to a challenge through the "How's Everyone Doing?" by selecting your username and then opening the task editor will not be saved, despite the presence of a "Save & Close" button. This is to prevent users from editing each other's tasks.

Day of Rest with No Damage
If you need a day of rest and don't want to take damage for unchecked Dailies during a challenge, you can add a checklist to a challenge Daily with one item and tick that item on days when you don't want to do the Daily but don't deserve punishment for it. Streaks are lost, and no XP and GP are gained, but no health is lost.

Challenge Participant's Permissions
When participating in a challenge, you have a limited amount of options for the tasks in the challenge. A challenge is meant to be accepted "as is" from the creator.

You can make these changes to your own copies of the tasks (the changes do not affect other participants):
 * Add/edit checklists for a challenge task. Currently, other players, including the challenge owner, cannot see the checklist, however this might change in future.
 * Add/edit notes on a challenge task. Other players can view changes made to the Extra Notes section.
 * Assign personal tags to the challenge tasks and/or unassign the challenge's tag. Other players cannot see the added tags.
 * Assign a task alias to the challenge task.
 * Change the tasks' attributes. This only applies to players who have task-based automatic allocation enabled.
 * Edit the streaks on Dailies.

You cannot make any other changes.

When you join a challenge, you should consider any changes that you make to the challenge tasks to be public (the only exception is that other players will never be able to see the names of your own tags). If you leave a challenge and keep the tasks, then they become private and changes you make after that time can not be seen by other players.

Customizing Challenge Tasks
If a player wants to make more changes to challenge tasks than a challenge participant can, the player can join the challenge, then leave the challenge again, choosing the "Keep Tasks" option. The challenge tasks stay in the player's task lists and are no longer connected to the challenge. The player can change them as desired, and delete unwanted tasks. But the player is no longer a challenge participant and can't win the challenge.

If a player wants to both customize the challenge tasks (for example, translate them) and be a challenge participant with a chance to win the challenge, the player can use the same method, but then join the challenge a second time. The player has both the original challenge tasks and their own customized version of the challenge tasks now. The player can now arrange them in pairs, read the customized (for example, translated) task, and check off the original task. If the player doesn't want to check off both versions of a task (and get double benefits and double losses), the customized Dailies should be permanently greyed out (so they don't damage the player's health) and the customized To-Dos deleted when the original To-Dos get done. It may also help to tag the tasks with the same tag so the player can select the original and customized challenge tasks at the same time.

Communicating with Challenge Creator
A player can communicate with the challenge creator by private message. Go to the Challenges page, find the challenge, and click on the creator's name to view their profile, which will have a private message icon at the bottom.

Public messages can also be sent to the challenge creator in the guild that the challenge is associated with; however it is not guaranteed that the creator will see them.

Creating a Challenge
To create a challenge, click the "Create Challenge" button and then specify which one of your groups can access it. All group members can create challenges in any group they are a member of, with two exceptions: groups where the group leader has chosen the "Only group leader can create challenges" option, and the Tavern (where you need to have at least one gem for the challenge prize). Only members in the specified group (and previewers if it is a public guild) will be able to view or join the challenge. Please note that you cannot change which group the challenge belongs to after the challenge is created, so double check that you have selected the correct group.

After selecting the group, enter the challenge title, a tag name (which will be applied to all tasks in the challenge) and a description for your challenge.

Specify how many gems the winner will receive. Tavern challenges require a prize of at least one gem. You must have at least one gem in your inventory to create a Tavern challenge. Prizes for private (Guild or Party) challenges are optional. The gems for the prize are usually taken from your account. If you are guild leader of the guild the challenge belongs to, the gems are first taken from the Guild Bank, and any more gems needed are taken from your account.

'Please note: You won't be able to change the prize after the challenge is posted. The amount of gems you specify as a prize is taken from your account (and/or the Guild Bank) when the challenge is saved. Gems will be refunded if you decide to close the challenge with no winner (except in the Tavern as the gems will be lost) or declare yourself the winner.'

Next, create the Habits, Dailies, To-Dos, and/or Rewards you want to include in your challenge; these will be shared with everyone who joins.

'''Please note: The tasks created first will appear lowest. The only way to change the order of challenge tasks inside a challenge is to delete and recreate them. Participants, however, can move the challenge tasks around on their own tasks page.''' (And reordering is already requested as a feature.)

Click "Save" to add your challenge.

If you think many other players would enjoy your challenge, you can advertise it in The Bulletin Board guild.

Cloning a Challenge
If you are the owner of an open challenge, you can copy it using the Clone button. This is extremely useful for creating a recurring challenge. The new, cloned challenge will have the the same information (name, description, prize, tasks) pre-populated, so the challenge creator can adjust only as needed.

Cloning a challenge (and closing the original) is also useful for older challenges: old challenges, especially those with a large number of participants, can encounter the "Entity too large" error. This error makes the challenge difficult to join, leave, edit, or close. Cloning and closing the challenge annually (or more frequently if it has a large number of participants) prevents this error.

Challenge Creator's Permissions
There are certain things that a challenge creator can and can't do.

The creator can:
 * Add the tasks for the challenge
 * Set the title of a task
 * Set the extra notes of a task (the participants can edit this text)
 * Define the difficulty of a task
 * Define a Habit as a negative, positive, or negative-positive Habit
 * Set the days of the week a Daily task is to be active on
 * Define a due date for a To-Do
 * Add and remove tasks at will

The creator cannot:
 * Set/edit the progress of the participant's tasks
 * Assign a task alias to the challenge task (however, individual participants can do this)
 * Add a checklist to a task (however, individual participants can do this)

Tip: When a challenge creator wants there to be a specific checklist on a task, they can create a To-Do that describes the checklist, and then each participant can follow those instructions.

Editing a Challenge
Once you have created a challenge, you may want to change the title, description, tag, or tasks. To edit the challenge, click on its title. Two buttons will appear under the challenge; the white Edit button and the orange End Challenge button.

Clicking the Edit button will open fields where you can change the challenge's title, tag, or description. Type in the new values.

You can also modify any tasks associated with the challenge.

When you're finished with your changes, click the blue Save button. You will need to refresh the page to see your changes. Any modifications you've made to the challenge will propagate through the tags and task lists of the participants. (However, if a task had notes to start with, and the challenge creator removes them, anyone who signed up when the notes existed will still have the notes.)

Staff and Moderators' Permissions
Staff and moderators are able to edit, delete, and close challenges, as well as declare a winner if they so choose. The potential scenarios in which they would use these privileges include (but are not limited to):
 * If a challenge violates the Community Guidelines or Terms of Service, an administrator might edit or delete the challenge, depending on the severity of the infraction.
 * If a challenge contains only minor violations, an administrator will only edit it if the challenge owner does not respond to an edit request within a reasonable timeframe.
 * If a challenge has been open for a long time, appears to be abandoned, and is not useful to other players, an admin will delete or close it. (A challenge that is left open indefinitely for a legitimate reason will not be closed.)

Challenge Tags
Most challenges have a tag specific to that challenge. These challenge tags are purple and include a megaphone icon so you can differentiate between your own tags and those of accepted challenges. By clicking on these challenge tags, you'll see which tasks are related to a particular challenge.

You can also add Habits, Dailies, To-Dos, or Rewards to these challenge tags if you have personal tasks that are related to that challenge's allocated tag. Adding your own tasks to a challenge tag does not make them part of the challenge for others to use or see. For example, if you join the challenge highlighted in the image, you could add an extra task under this challenge tag called "Complete the challenge". However, no one else participating in this challenge would see your added task, nor would this task count as being part of the official challenge.

When a challenge is over, the megaphone icon disappears and the tag will look like a regular tag.

Challenge Tags Remaining after Leaving a Challenge
After a player leaves a challenge, the challenge tag that was associated with it is not deleted and will remain alongside other existing tags. This is deliberately done to allow players who might want to use the challenge tag for their own tasks or who want to leave the challenge tasks in their task lists after they have left the challenge, to be able to do so if they wish. For either case, automatically deleting the challenge tag after leaving a challenge would be inconvenient for the players involved.

If you wish to delete a challenge tag or any other tag, you can do so by clicking "edit" next to your tags and then clicking the trash can icon on the tag.

Sharing a Challenge
Each challenge has a unique identifier that is a string of letters and numbers. The challenge identifier can be found by clicking on the challenge. Then, your browser address bar will contain a URL that looks like this: https://habitica.com/#/options/groups/challenges/c6839e9a-6e2d-419a-b009-f4466c486647. This is the link that can be used to share your challenge. You can post this link in the Tavern or other public places on Habitica to invite other players to join. (If it is a guild challenge, they will need to join your guild first before joining the challenge.)

When a player clicks the challenge link, they will see the description and tasks for that challenge only. If they want to return to view all available challenges, they can click the blue "Back to all challenges" button.

Promoting a Challenge
The Bulletin Board 📌 guild is a good place to promote your challenge.

If you would like more exposure for your challenge, you can submit it to be featured on the official Habitica blog by filling out this form. To qualify, your challenge must have a fixed end date and a gem prize of any amount.

Note that if your challenge is in a private guild, the only users that will be able to view the challenge, even if provided the link, are users that are in the private guild.

Leaving a Challenge
To leave a challenge, click the red "Leave" button. A pop-up window will open, giving you the options to remove the associated tasks, keep them, or cancel.

You can rejoin the challenge if you so choose.

If you leave a challenge but forget to click the option for removing tasks, or if you did select that option but the tasks remain, rejoin the challenge and then leave it again, being careful to select the desired option.

If you leave the challenge and keep the tasks but decide to join the challenge again, you might see both sets of challenge tasks listed. Delete the first set of tasks, as they are no longer linked to the challenge. Only the second set of tasks counts for the challenge.

If, after creating a challenge, you do not want the tasks to remain on your list, but wish to leave the challenge open to others, simply leave the challenge without closing it. The challenge can still be accessed as normal, and you will be able to find it in the "owned" section of the challenge list.

Closing a Challenge
Currently, there is no option to set an end date when creating a challenge. The challenge deadline is at the creator's discretion and a challenge can continue indefinitely. Only the creator can end the challenge.

To end your challenge, click the "End Challenge" button under your challenge's name. You will be given the options to choose a winner or to delete the challenge without choosing a winner. If you delete a challenge in the Tavern without choosing a winner, the challenge's prize gems will be permanently lost (see ). If you delete a challenge in a guild or party without choosing a winner, the challenge's prize gems will be refunded to you.

To declare a challenge winner, select a winner (which can be yourself) from the drop-down menu. Challenges can have only one winner. If you would like to award a second prize, you can create a second challenge with the same name after the first one closes, invite the second place winner to join, and then end the challenge in favor of that person.

If you are not sure who to select as the winner, consider downloading data from the challenge by clicking the blue "Export to CSV" button at the bottom right hand corner of your challenge. This can help in a few ways: These factors may help you eliminate users from the running.
 * The old HabitRPG app allowed users to delete tasks even if those tasks were a part of a challenge. If a user has deleted a task that was a part of your challenge, it will be apparent on the CSV.
 * If the challenge includes a To-Do that requires more than one day to complete (e.g., "Achieve a 14-day streak on the challenge Daily") and a user has a score of 0 or 1 on that To-Do, it means one of the following: they were resting in the Inn for the duration of the challenge, they checked off that To-Do on their first day participating in the challenge (i.e., they cheated), or they simply have not used Habitica since the day they joined the challenge.
 * Users who have been resting in the Inn without checking off any challenge tasks will have a score on required Dailies that is the same as all their other scores.
 * Users who have not completed a required Daily very often (but have not been resting in the Inn) will have a negative score on that Daily.

If you are still not sure who to select as the winner, consider counting how many users remain in the running (again, the CSV is useful for this) and using a random number generator such as the one at random.org to select a random user. If the challenge required completion of certain To-Dos, you may want to click that user's name under the challenge's details to verify that they have checked those off. If the challenge contains any To-Dos that you can personally verify were completed, such as "Post about your experience in the guild chat", you may also want to verify that the user completed these To-Dos before assigning them as the winner.

Once challenges are closed, they are deleted and cannot be retrieved.

Collecting a Challenge Prize
If you are lucky or talented enough to win a challenge, two things will happen. First, if the challenge awards gems as a prize, these will automatically be added to your gem count. Second, even if no gem prize was given, you'll still receive a beautiful achievement badge! All challenge achievements, even those from private guilds or parties, can be proudly displayed on your profile.

Deleting a Challenge Task
To delete tasks from a challenge that has not yet finished, you need to leave the challenge.

When a challenge ends, the megaphone icon on the tasks associated with the challenge should "break"—that is, the icon will appear with a red background behind it to signify that the challenge no longer exists. To delete tasks when a challenge has finished, click on the broken megaphone that says "Broken Challenge Link" and it will ask you whether you want to keep the task. If you click "Remove Tasks" and the tasks remain, reload the page and they will then disappear.

If the challenge appears to no longer exist but you don't have a broken megaphone yet, try checking off any Habit, Daily, or To-Do that belongs to the challenge, then reload Habitica. That should sync your task list with the server and turn the megaphone into the broken megaphone icon.

If the challenge had only To-Dos and you had completed them all, go to the Done tab of the To-Dos list and then uncheck (undo) one of them to make the megaphone become broken.

In some cases, you might need to repeat those actions a few times, possibly over several hours, before the broken megaphone icon appears (e.g., if your first attempt doesn't work, wait a few hours and try again; then if necessary, try again the next morning, and then a few hours after that).

You might find that you can delete challenge tasks using the Mobile app even if you can't delete them on the website.

If the broken megaphone icon has still not appeared after you've tried these suggestions for two days, report the problem by using the "Report a Bug" link from the Habitica website's Help menu.

Saving/Running Challenges at a Later Date
There are many methods for saving a challenge to be run at a later date; most methods use cloning. When cloning the challenge to your storage area, do not add gems. Only add gems to the challenges you are ready to make available.

By Private Guild
Create a private guild and put a clone of the challenge in it. Leave that clone, end or delete the original challenge, and let the clone in your private guild sit there for as long as you want. Make clones in other guilds whenever you want to actually run the challenge somewhere.

Creating a private guilds costs 4 gems, but you can get those gems back by creating a guild challenge with the gems from the guild bank, then either declaring yourself the winner or simply ending the challenge. This is the most commonly used method.

Library of Shared Lists
If the challenge is of interest not just to you but to many Habiticans, you might want to put it into the 📜 Library of Shared Lists guild. (See guild description on the guild page to see how the Library works.) If the challenge tasks don't make sense for one player alone (for example, if the challenge provides a method for two players to have a duel, or if the challenge is trying to revive a guild [e.g., "post in chat", "create a guild challenge", "invite someone to the guild"]), you can add the word "(template)" or "(sample)" or "(example)" or similar to its name and add to the description that other players can copy and adapt this challenge for challenges in their own guilds. (The copying would have to be done by hand. Cloning other people's challenges isn't possible.)

Challenge Sandbox
If you want to create a challenge now and run it later, but don't want to store it after that, you can use the Challenge Sandbox guild to build it and let it sit there for a few weeks or months but not longer than a year. Note that anyone can wander in and see the challenge there. If the planned challenge start date is more than one or two months away, it is best to say so in the challenge description or in guild chat, so no one thinks you forgot about the challenge. For details on how The Challenge Sandbox works, see the guild description on the guild page. This is useful if you want people to help, share ideas, and proofread, but is not the best approach if you want the challenge to be a surprise.

Store in the Guild Itself as a Sample
You can even ask in the guild where the challenge is supposed to run (especially if it's a small guild or if you are the guild leader) if you can store a "challenge template" or "sample" there. (For example, the "sample version" challenges in the ⚔ The Duelling Grounds ⚔ guild are exactly that.) The challenge description should explain clearly that it is a challenge to be copied and used later (or repeatedly), and that people should not join the sample version.

In Your Party
Challenges in parties work the same way as in guilds. If you are in a one-person party, you can use that instead of your own private guild to store challenges. The advantage is that you don't have to juggle gems to create one. The disadvantage is that if you want to invite more people to your party later, they will see the challenges. If you want to give up your one-person party later to join a bigger party, you'll have to move the challenges elsewhere first.

Bookmarking with URL
Maybe you simply wanted a method to "bookmark" challenges created by other people to join them later. In that case, you can just bookmark them using the bookmark/favorite function of your browser. See Sharing a Challenge.

Official Habitica Challenges
Official Habitica challenges are challenges created by Habitica's staff. Because they are placed under the Tavern group, they are site-wide and open to all players. The Official Habitica Challenges page provides a list of all past and present official challenges.

Inappropriate Challenges
If you see a challenge that you believe contains inappropriate material (e.g., offensive content), please email leslie@habitica.com (Lemoness) to report it to her (rather than mentioning it in the Tavern).

Défis