UsageInstall the app. Log in using the same details you use at the Habitica website. Report bugs at Menu > About > Report a Bug.
Habitica for iOS is an official mobile client for Habitica users. The app functions as an add-on or replacement for the Habitica website, and is currently in active development.
The iOS app header is at the top of the screen in several of the app screens. If it is missing, swipe down to scroll up. The header contains the title of the current screen, the player's avatar, health bar, experience bar, mana bar (for level 10 and up), display name and Username, current level, class, buff status (if active), Mystic Hourglasses, gems, and gold. An alternate name, level, and class colors signify the Contributor Tier of the player.
You can create, check off, and edit Habits, Dailies, and To-Dos via the app. You can also create, edit, and redeem Rewards, including custom rewards. You can navigate between each type of task by tapping on their respective icons at the bottom of the screen. This takes you to the different pages for each type of task. The "Habits" page is automatically opened when the app is started.
Creating and Managing Tasks Edit
To create a new Habit, Daily, To-Do, or Reward from the mobile app, go to the desired type of task by tapping on its respective icon on the bottom of the screen, then tap the plus (+) icon in the upper right hand corner of the screen. This will cause an additional page to pop up. Depending on the type of task to be created, the page has different fields and options available. The task name, description, difficulty, and tags fields/options are available for all tasks. Additionally:
- For Habits, you can set whether the habit has positive or negative actions or both, and the frequency at which the streak resets.
- For Dailies, you can add a checklist and set the frequency and Repeat Options of the Daily. You also can set Reminders, which alert you on the days when the Daily is active, and specify at what time these appear.
- For To-Dos, you can add a checklist and due date. You can also set Reminders for To-Dos.
- The Enchanted Armoire and Health Potion rewards cannot be unpinned from the Rewards tab.
- You can pin additional items to the Rewards tab by selecting the "Pin to Rewards" button on items in the Shops section of the Menu.
- Emoji in text-based custom rewards will display as normal. However, using Markdown to change font qualities such as bold, italic or heading level will just display the Markdown codes.
- To delete a custom reward, tap on the reward to open the Edit Reward screen, then scroll to the bottom of that screen and choose "Delete."
- Habits: Players can filter Habits by their Task Values. Selecting the "Weak" filter will only display habits with a Yellow value or worse. Selecting the "Strong" filter will only display habits with a Green value or better.
- Dailies: Players can filter Dailies by whether or not they are currently due. Selecting the "Due" filter will only display dailies that are due today and that have not yet been checked off. Selecting the "Grey" filter will only display dailies that are not due today or that have already been checked off.
- To-Dos: Players can filter To-Dos by whether or not they have a due date or whether or not they have already been completed. Selecting the "Dated" filter will only display To-Dos which have a due date assigned. Selecting the "Done" filter will only display To-Dos which have been completed in the current session (once the app is refreshed or restarted, completed To-Dos are not visible with this tag). Unchecking a completed To-Do using this filter will restore it as an active To-Do, causing you to lose the previously earned experience and gold from completing it.
- Profile - edit the Display Name, Photo, and "About" text displayed on your Profile.
- Authentication - change your Login Name, E-mail, Password, Login Method, and Reset Account.
- API - view and copy your User ID and API Token.
- Fix Character Values
- Change Class
- Log Out
- Set whether the app provides a Daily Reminder and at what time. Note: Notifications from the Habitica app have to be allowed on your device for these reminders to function properly. Activate this option under your device's Notification settings.
- Display Notification Badge - allow the app icon to display the number of incomplete Dailies remaining.
- Custom Day Start
- Under the "Social" heading, you can Disable all Push Notifications, and/or Disable Private Messages.
- Under the "Preferences" heading, you can set your Sound Theme for the iOS app and your desired Theme Color.
- Under the "Maintenance" heading, you can Clear Cache and Reload Content.
When the desired information is inserted, press Create in the upper right corner to create the task.
When you tap a Habit, Daily, To-Do, or Reward, you are brought to an edit page where you can view the details for or edit that item. You can also delete the task by selecting the Delete button at the bottom of the page.
You can reorder tasks by pressing and holding on a task, then dragging it to the new location.
Habits Tab Edit
Your Habits are listed under the Habits menu. You can tap the + or - as you normally would on the website to score a good or bad habit. Habits can be edited by tapping on them, and you can search for a specific Habit by using the search bar.
Dailies Tab EditYour Dailies are listed under the Dailies menu. You can check off your Dailies by tapping the respective checkboxes. Each of the Dailies will also have information on streaks,, if any. You can also add Dailies by pressing the plus button on the upper right side of the screen.
Checklists can be accessed by tapping the colored box on the right side of the Daily; once the Daily is expanded, checklist items can be ticked off normally. To add checklist items, tap the white portion of the main Daily box, tap the green plus button, and type in the contents of the checklist item. Checklist items can be rearranged by holding down the three lines to the right of each checklist item and moving to the item to its appropriate place in the checklist.
The search bar can be used to navigate your Dailies, which are all shown by default, even the grey/completed ones. A purple number in the corner of the Dailies icon displays how many Dailies you still have due before your next Cron.
To-Dos Tab Edit
Your To-Dos menu contains all active To-Dos by default. You can check off your To-Dos by tapping the checkboxes, and the checklists can be accessed by tapping the checklist progress button on the right side of the To-Do. To-Dos can be edited by tapping on them, and a search bar can be accessed at the top of the list.
Rewards Tab Edit
Under Rewards, you can see and purchase equipment, health potions, Enchanted Armoire items, and custom rewards. Clicking on the reward reveals any description, the option to unpin the item from your Rewards screen, and the Buy button. A reward cost will be dimmed if you do not have enough gold to purchase it.
Filtering Tasks Edit
Using the filter option allow players to only view Habits, Dailies, and To-Dos that include a certain tag (or tags) as well as specific attributes of a task, whether it is due, etc. This function can be helpful for players who are sifting through a significant number of tasks or players that wish to focus only on a certain type of task at a time.
To Filter tasks on any of the task screens, click the Filter button in the top left corner to display all current tags. Tags are automatically generated for challenges that the player has participated in. Additionally, players can create custom tags by selecting the + sign in the top right corner.
Adding a check mark next to a tag will apply that filter across all types of tasks (Habits, Dailies, and To-Dos) until unchecked. Checking multiple tags at once will make the filter more specific, rather than including tasks from each different type of tag. All tags can be cleared at once using the "Clear" button, located at the bottom right of the screen. Tags can also be deleted by using the Edit button at the bottom left of the screen, selecting the red - button next to tag, and choosing the "Delete" button.
In addition to filtering tasks by tags, players are also able to filter tasks by other mechanisms that are unique to each type of task. Using these filters will only apply to that particular type of task, rather than apply across all types of tasks:
Menu Tab Edit
The Menu tab serves as a hub for all other social, character, and administrative functions of Habitica. In addition to providing a way for users to send private messages, manage account settings, use skills, and allocate stat points, the Menu tab divides additional menu options into three categories: Social, Inventory, and About. At any time while navigating these menu items, the back arrow in the upper left can be used to navigate to the previous page.
Main Menu Functions Edit
The Messages, Settings, Use Skills, and Stats functions are not categorized and can be accessed from the top of the main Menu page. If there is an active world boss, you can also see a snapshot of the boss's remaining health and your pending damage on this page.
The Messages function is accessed by clicking the envelope in the top right corner of the main Menu page. Here, you can view your private messages. The text box to respond to a message is below the message and above the Task Tabs at the bottom of the screen. To learn how to send a private message to a party member, see the Party subheading in this section.
The Settings screen is accessed by clicking the gear icon in the top right corner of the main Menu page. It contains the following selections:
Use Skills EditThe first section of the Menu tab allows you to use your skills. Once you tap on the section, a list of your character's skills as well as their short descriptions will appear. Skills that you are able to use will have their information typed in regular black font. However, if there are skills that you do not have enough mana to use, the skill will be displayed in grey font. Once you have enough mana, these skills will turn black again, and you will be able to use them.
Click on a skill to use it. For skills that require a target task, such as Pickpocket, you will be allowed to pick the relevant task on the next screen. Do remember, however, that these skills do not work on challenge tasks. On the second screen, challenge tasks will be greyed out, and a description will remind you that you cannot use skills on challenge tasks. If you accidentally tap a challenge task here, you will not lose mana - just pick another task as the target of your skill.
The second menu option allows you to view your current Character Attributes and to allocate any points you have received from gaining levels. It also offers the option to Auto Allocate Points based on your class, and provides a "Stat guide" which describes the effect of each stat.
Social Heading Edit
The Tavern is divided into the "Details" and "Chat." The different sections in the Details tab can be collapsed and expanded by clicking on the arrow next to the respective sub-headers. It consists of "World Boss" (when there's an active one), "Check into Inn", "Community Guidelines", and "Helpful Links."
World Boss Edit
When a world boss is active, this section will appear. Clicking the question mark will provide more information about how to participate against a world boss, and clicking the arrows can collapse and expand the Boss Art and World Boss Description.
Below the Boss Art, the name of the boss, its health, your pending damage, rage attack name, and rage bar are displayed. The Rage Strikes section shows the possible strikes, which will be unleashed when the rage bar is full. Below that, the current world boss story is written.
Check Into Inn Edit
To check into Daniel the Bard's Inn, tap the orange "Pause Damage" button. You will not be penalized for your missed dailies while checked in, and your avatar will appear to be sleeping. To check out of the inn and resume the normal function of dailies, tap the same orange button which will say "Resume Damage."
Community Guidelines Edit
This section links to the Community Guidelines, which define the standards Habitica holds it citizens to in order to create a culture where everyone can be safe, happy, and productive as possible.
Helpful Links Edit
This section provides two useful resources: easy access to the FAQ and a way to report bugs. Both buttons will direct you to the respective in-app section, and are not external links. The FAQ button will open the "Help & FAQ" sub-section, found in the menu under the "About" section. The Report a Bug button will open the "About", that allows you to send an email to the developer, along with your app's debugging information.
On the "Details" tab at the top of the Party page, you can see your party's current quest, description, challenges, and members.
The Quest tab displays the name, number of participants, and progress of any currently active quests. If no quest scroll has been used, the option to invite party members to a quest is displayed. Further information on the quest can be accessed by tapping on the quest name, and if you are the quest scroll owner or the party leader, you can Begin and Abort quests by tapping that option in the top right corner of that page. You can have the app send you a notification when your quest has started. If a quest is aborted, the scroll will be returned to its owner and can be restarted at a later time.
The "Party Description" tab displays the customized description of the party (if one is written). Underneath this section is the "Party Challenges" button, which will show all party challenges that you are currently participating in (under the "My Challenges" tab) and other available party challenges (under the "Discover" tab).
The "Members" tab offers the option to invite new Habiticans to your party via their Username (for players already registered on Habitica) or Email (for players who have yet to register). It also displays all party member's avatars, display names, usernames, level, class (demonstrated by the icon next to their display name), health bar, experience, and mana. The party leader can also identified by a "Leader" icon to the right of their display name.
Tapping on a party member from the "Members" page leads to their profile. The profile includes the party member's full avatar, stat bars, level, username, "About" section, "member since", last log in, battle gear with stats, costume, and attributes. You can send and view messages from the selected party member from the compose icon in the top right. The text box will be at the very bottom of the screen.
On the "Chat" tab listed at the top of the Party page, you can communicate with your Party, see quest progress, and observe casting messages. All of these items are listed in chronological order, with chat messages displaying the time that has lapsed since it was written and a headshot of the party member's avatar.
Tapping "Write Message" allows you to send a message on the party chat. On the iOS app, the last 200 party messages are shown.
Note that the Skills you can use with your party can be accessed at the top of the main Menu page under "Use Skills," rather than on the Party page.
Guilds are accessible through the app. You can join guilds, read and respond to guild messages, and participate in guild challenges. However, you cannot use the app to create a guild.
You can browse through and join public guilds by tapping on the option at the bottom, "Public Guilds".
On the Challenges page, you can view challenges that you have joined and join public challenges from the Tavern and guilds you have joined. There isn't a way to create or clone challenges on the app.
You can search or filter through challenges on the top of the page.
You can view the challenge description and challenge tasks by clicking on the challenge name.
Inventory Heading Edit
Shops, avatar customizations, equipment, items, your stable, and information on purchasing gems and subscriptions can be accessed by opening the Menu tab and tapping on the relevant entry under the Inventory heading.
The shops page lets you access the Market, Quests shop, Seasonal Shop and the Mysterious Time Travelers to purchase equipment, pets, gems, etc. just as you can on the Habitica website. Items can be purchased directly from the shops or pinned (and unpinned) to your Rewards tab by simply selecting an item and pressing the appropriate option.
Customize Avatar Edit
You can customize your avatar's body, head, and background on the "Customize Avatar" page. New items may also be purchased from the app.
Body size can be changed by tapping on either the slim or broad options on the right, and shirts, skin, animal ears, and wheelchairs can be customized by tapping on the relevant button and selecting your preference. Your avatar's hair color, base, bangs, flower, beard, and/or mustache can be changed in the same way.
Backgrounds can also be changed and purchased from the app.
On the equipment page, you can see and change what your character is currently wearing. There are two categories of wearable equipment - battle gear (which influences your character's statistics) and costumes (which are just for show). While battle gear is recommended, costumes are optional. To put on your costume, toggle the slider at the top of the costume section.
Both battle gear and costume items can be changed from the app. To do so, select the area where you would like to equip a new item (i.e., the head, head accessory, eyewear, armor, body, back, shield, or weapon). You are then taken to an inventory of items that can be equipped on that area, listed in alphabetical order. To help you select the right item, a description of the item and its effects on your stats will appear on the select item screen. Tap the item you would like to equip and it will become highlighted in purple, signifying that it is equipped. To unequip an item, simply tap it again and the purple highlight will disappear.
The Items page is where you can find your eggs, food, hatching potions, and quests. You can sell items, hatch eggs, and invite your party to quests, but you cannot feed your pets from this screen (Feeding is instead done via the Stable screen). The number of each item you have is shown on the right side in pale grey.
You can sell any item by tapping on it and tapping the red sell (x Gold) button that pops up. You can hatch eggs by tapping an egg or hatching potion, selecting either Hatch egg or Hatch with potion, and tapping the egg or hatching potion you would like to combine it with. If a hatching potion cannot be used on a certain egg (because you already own the pet or the potion can only be used on certain pets), those eggs will appear faint and grey and cannot be selected. You can cancel a hatching by pressing Menu in the top left corner before pressing the second item.
You can also invite your party to a quest by tapping on a quest and then selecting Invite Party.
The Pets page is where you can find all your pets, sorted by category (i.e., Standard, Quest, Wacky, and Special), and then listed by type (e.g., Bear Cub, Cactus, Cheetah, Octopus). For each type of pet, the page will show the name, image of the pet egg, and the number of pets of that type that you have hatched over the total number of pets you can hatch of that type.
By tapping on a type of pet, you are taken to the Type screen, where you can see which pets you have and their food bars, which pets you used to have (in which case they are semi-transparent and lack the food bar), and which pets you have not yet hatched (these are indicated by a gray outline of the pet).
To equip a pet, tap the pet you would like to equip and choose Equip when that option pops up.
To feed a pet, tap the pet you would like to feed and then select Feed. You will be taken to a page with a list of the foods you have; then, select the desired food. You can always select Cancel in the top left hand corner of the app if you would no longer like to feed the pet.
Similarly to the Pets page, the Mounts page is where you can find all your mounts, sorted by category and then listed by type. For each type of mount, the following is shown: name, image of the base mount's head, and number of mounts you have tamed of that type. If you have not yet tamed a mount of that type, the mount's name will appear gray.
You can ride a mount by tapping on the desired mount and selecting Equip when the option pops up.
Gems & Subscription Edit
Here, you can purchase gems and subscribe to Habitica using your Apple account. A subscription allows you to purchase a limited number of gems each month with gold, regularly awards you with special equipment, and provides you with mystic hourglasses at various time milestones. If you are already a subscriber, this page will also display your payment method, consecutive months subscribed, monthly gem cap, and current number of mystic hourglasses.
To unsubscribe, select the "Open iTunes" button to open the appropriate page within the iTunes app.
About Heading Edit
The last section of the menu allows you to check the News, view Habitica's FAQ, and get information "About" your app.
Help & FAQ Edit
On this page, you will find a list of Frequently Asked Questions (FAQs) about using Habitica. You can search the FAQs using the search box at the top of the list. At the bottom of the list is a link to Reset Justin's Tips. Use this to get helpful information on using the app the first time you access a screen.
From here, you can access a link to the mobile site, send in feedback, report a bug, link to Twitter, leave a review, view the source code, view the acknowledgements, or view version information.
Tutorial Coach Mark Edit
If users have a tutorial available for view, a purple circle will appear in the middle of the screen. Tapping on this "coach mark" will activate the tutorial.
Help! My App is Misbehaving! Edit
If information is not displaying correctly in your app, or you are unable to perform a function as expected, please try the following steps.
- Check that you have the latest version of the app at the Apple Store.
- Perform a soft sync by going to Menu > Settings > Maintenance > Reload Content.
- Clear your cache by going to Menu > Settings > Maintenance > Clear Cache.
- Uninstall the app, power cycle your device (i.e., turn it off then back on), and reinstall the app. This will force all Habitica data to be removed from the device and cleared.
- If all the steps above fail, report the bug in the app under About > Report a Bug. This option is preferred because it automatically captures your device information and the report is sent directly to the developer to analyze. (If you are unable to use the in-app bug reporting, it is also possible to report iOS issues in the Report a Bug guild.)