The official iOS mobile app can be downloaded for free from iTunes. It contains all the major features of the Habitica website (checking off tasks, chatting in the Tavern, accessing your Party, etc.).
UsageInstall the app. Log in using the same details you use at the Habitica website (either Facebook login or username and password). Report bugs at GitHub or 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. If it is missing, swipe down to scroll up. The header contains the player's avatar, health bar, experience bar, mana bar (for level 10 and up), username, current level, class, gold, silver, and gems. Tapping on the gem count takes the player to the Gems & Subscriptions screen.
You can create, check off, and edit Habits, Dailies, and To-Dos via the app. You can also create, edit, and redeem 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 add 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 positive and/or negative actions.
- For Dailies, you can add a checklist and set the frequency and applicable day(s). 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.
When the desired information is inserted, press Save 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 reorder tasks by pressing and holding on a task, then dragging it to the new location.
To delete a task, swipe left to reveal the Delete option, then tap that option.
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 swiping up to locate 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.
A search bar can be accessed by scrolling up to navigate your Dailies as all Dailies are shown by default, even the grey/completed ones. A red 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 incomplete To-Dos by default. To see completed To-Dos, tap Filter at the top-left of the list. 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. Descriptions are shown by default. Rewards will be black if you have enough gold to buy them and grey if you do not.
You cannot use skills through the Rewards tab, but they are accessible as the first option under the Menu tab.
Your current levels of gems, gold, and silver are displayed at the top of the screen at all times, unless you are adding or editing a task.
- Emoji will display as normal. However, Markdown to change sizes will make the text smaller, and code will appear in a serif font.
- Tags are accessible through the upper left hand corner of the Habits, Dailies, and To-Dos screens.
Menu Tab Edit
The back arrow in the upper left can be used to navigate back to the previous page.
Use SkillsEditThe 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.
Here, you may also cast Transformation Items on your party members.
Social Heading Edit
Here, you can view your private messages. You can also send private messages to others by tapping the compose icon in the top right. It is necessary to type the recipient's User ID or scan their QR Code to send the first message. 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.
Under this page, you can access the Tavern Chat and have the option of resting in the Inn. (The mobile app calls resting in the Inn "Pause your Dailies.") The Tavern Chat does not display avatars or profiles next to chat messages, but player names are colored according to their contributor tiers.
To Rest in the Inn, tap the Pause your Dailies text next to the image of Daniel the Bard in the Inn. To leave the Inn, tap the Reactivate your Dailies text.
On this page, you can see your party's information, current quest, and chat.
Under your party's name there are two tabs: "About" and "Members" with the number of members. "About" leads to the name of the leader of your party. "Members" leads to a list of party member's user names, avatar (without pets, mounts, or backgrounds), level, class, and health bar. At the top right of the "Members" page is "Invite". This can be used to invite players to join your party with their User ID or email.
Tapping on a party member from the "Members" page leads to their profile. The profile includes the party member's avatar, stat bars, level, "member since", last log in, battle gear with stats, costume, and attributes. You can send and view messages from selected party member from the compose icon in the top right. The text box will be at the very bottom of the screen.
The header with your avatar and stat bars will appear at the top of the screen above the selected party member's avatar and stat bars.You can also find the party's current quest, including its name, number of participants, and progress. Further information on the quest can be accessed by tapping on the quest name, and further information on the participants can be found by tapping on the participant number. You can have the app send you a notification when your quest has started.
Tapping Write Message brings up a new screen for typing. Below Write Message are member messages, quest progress by member by day, and casting messages - all in chronological order. On the iOS app, messages go back one month.
Note that the Skills you can use with your party can be accessed at the top of the Menu tab.
Guilds are accessible through the app. You can join guilds as well as read and respond to messages in guilds that you are currently in. 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
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 shirt, skin, and animal ears can be customized by tapping on the relevant part of the avatar and then picking the new option.
Similarly, hair color, base, bangs, flower, beard, and/or mustache can be changed by tapping on the relevant part of the avatar and then picking an option.
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 bottom of the page.
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, sorted by Class, Special, and Armoire items from the Enchanted Armoire. 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 then tap the Equip button that pops up. To unequip an item, tap it again and then tap the Unequip button that pops up.
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 Pets 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, and then tapping the hatching potion you would like to pour over them (or vice versa). You can cancel a hatching by pressing Cancel 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., Special, Base and Quest Pets), 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 base pet (or, if you have not hatched the base pet, another pet of that type that you have hatched), and the number of pets of that type that you have hatched over the total number of pets you can hatch of that type.
The Group By option in the top right-hand corner allows you to sort the pets by color instead of type, as well as switch back. Grouping by color works similarly to the default option (grouping by type). For each color of pet, the page will show the color; image of a Bear Cub (for base pets) or Armadillo (for quest pets) or, if you have not hatched the base pet, another pet of that color that you have hatched; and the number of pets of that color that you have hatched over the total number of pets you can hatch of that color.
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 with a paw icon with a question mark in it).
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.
Mounts EditSimilarly 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 base or tamed mount, and number of mounts you have tamed of that type. If you have not yet tamed a mount of that type, the icon of the paw with the question mark will be shown.
You can ride a mount by tapping on the desired mount and selecting Mount when the option pops up.
Gems & Subscription Edit
Here, you can purchase gems and subscribe to Habitica using your Apple account.
The latest News, as reported by Bailey on the Website, can be found here. Older news can be accessed by tapping on Read older news at the end of the most recent news.
You can access your User ID and API Key from Account Details. Other things that are available there are your QR code, log in name, email, and log-in method.
You can change your class, which costs three gems, by tapping Change Class.
You can log out by tapping Log Out, or you can activate a Daily Reminder and specify at what time this reminder appears. 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.
Additionally, under Display Notification Badge, you can allow the number of incomplete Dailies you have to be displayed on the app icon. This allows you to see how many pending Dailies you have left without opening the app.
Habitica's default day start is midnight, you can enter a deviating Custom Day Start time.
You can disable all, or choose which Push Notifications to receive - use the toggle switch to dis- or reenable push notifications and tap "Push Notifications" to open the sub-menu. Check the notifications you want to receive, uncheck those you don't.
You can further deactivate Private Messages by using the toggle switch and reactivate them again.
You can also Clear Cache and Reload Content under the settings menu.
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, access the FAQ, 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 Report a Bug guild, on GitHub, or in the app under About > Report a Bug. The third option is often preferred as it automatically captures your device information and the report is sent directly to the developer to analyze.