Habitica Wiki
Habitica Wiki


Habitica's official iOS app can be obtained for free from the App Store. It contains all the major features of the Habitica website (managing tasks, chatting in the Tavern and Guilds, accessing your Party and Inventory, etc.). It is under active development.

The Habitica app login screen


Install the app. Log in using the same details you use at the Habitica website. Report bugs at Menu > About > Report a Bug.


IOS Header.jpg

The Habitica for iOS 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.

Task Tabs[]

You can create, check off, and edit Habits, Dailies, and To Do's via the app. 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. By default the "Habits" page is automatically opened when the app is started, but this can be changed in the Menu tab.

Creating and Managing Tasks[]

The Add Habit screen on the iOS app

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:

Setting a Reminder on a Daily.

  • For Habits, you can set whether the habit has positive or negative actions or both, and the frequency at which the streak counter 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 Do's, you can add a checklist and due date. You can also set Reminders for To Do's.

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.

Filtering Tasks[]

A sample Filter screen on the Habits tab

Using the filter option allow players to only view Habits, Dailies, and To Do's 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 Do's) 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:

  • 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 Do's: Players can filter To Do's 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 Do's which have a due date assigned. Selecting the "Done" filter will only display To Do's which have been completed in the current session (once the app is refreshed or restarted, completed To Do's 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.

Habits Tab[]

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[]

An expanded Daily with a checklist.

Your 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 Do's Tab[]

Your To Do's menu contains all active To Do's by default. You can check off your To Do's 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 Do's can be edited by tapping on them, and a search bar can be accessed at the top of the list.

Rewards Tab[]

Under Rewards, You can create, edit, and redeem Rewards, including 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.

Please Note

  • 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."

Menu Tab[]

The complete menu of non-task functions, accessible by clicking the three horizontal bars in the lower right of the screen

The Menu tab serves as a hub for all other social, character, and administrative functions of Habitica. The header at the top allows players to access notifications, messages, and settings. The menu below that has several uncategorized options at the top, followed by four categorized sections: Shops, Inventory, Social, and About. When you select a menu item you'll be taken to a new screen, but you can navigate back to the previous page using the App iOS button back.png back arrow in the upper left of the screen.

Header options[]

App iOS menu header.png

The header is the purple bar at the top of the screen, visible only when you are in the non-tasks menu. On the left it shows a portion of your avatar, your display name, and your username. Towards the right it has three icons: a speech bubble for "notifications", an envelope for "messages", and a gear for "settings".

Tapping any of those three items will take you to their submenu. To exit the any of the header submenus, click "Done" in the upper right.


App iOS button notifications.png
The speech bubble icon is for activity notifications. If you have one or more notifications waiting for you, there will be circled number in the upper right corner of the speech bubble.
Notifications can include unread Bailey news updates, activity in your party, and new mystery items among other things. Clicking on this icon will show a list of all the pending notifications, and clicking on any notification will take you to the source of that activity.


App iOS button messages.png
The envelope icon is for messages, and will allow you to view and send private messages with other players. If you have unread messages, there will be a circled number overlapping the upper right corner of the envelope.
  • To send a new private message, click the pencil icon in the upper left and type in the username of the person you want to write. If that person is in your party, you can initiate a private message without going through this menu - the Party subheading in this section explains how.
  • To view/respond an existing message, just tap on it. It will switch to a screen with your entire message history for that person. Once in this screen you can tap "Profile" in the upper right to see the user's profile. To respond, tap on the "Write message" box at the bottom of the screen. To exit back to the list of private messages, click the "< Messages" link in the upper left.

Settings Menu[]

App iOS button settings.png
The gear icon is for the settings menu. This is where you can find most account-related settings including login options and interface preferences. Some are part of larger categories, and others are on their own
  • My Account: This opens another long menu, detailed below.
    • Account Info (Username · Email): You can change your username here, as well as the email address associated with your account.
    • Login Methods (Password · Google · Apple): Set up or change your login password, or 3rd party authentication via Google or Apple.
    • Public Profile (Display name · About · Photo URL): You can change the Display Name, Photo, and "About" text displayed on your Profile. The Display Name is also what appears when you post in the Tavern or a guild chat.
    • API (User ID · API Token · Fix Character Values): Allows you to view and copy your actual User ID and API Token - these are system keys, so they cannot be changed. You can also change your HP, MP, EXP, Gold, and Level via Fix Character Values.
    • Danger Zone (Reset Account · Delete Account): Be careful with these! They can't be undone.
  • Change Class: Allows you to change your class, but retain all experience and gold. Costs 3 gems.
  • Log Out: Logs you out of the app, requiring you to log in to use it again.
  • Reminder: 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.
  • Notification Badge: Allow the app icon to display the number of incomplete Dailies remaining.
  • Day Start Adjustment: Set when your Habitica day "starts" (the default is midnight in your time zone).
  • Social: Completely disable push notifications, email, and/or private messages. Alternatively, set which push notifications and/or emails you do want to receive.
  • Preferences: Set your interface language, sound theme, theme color, theme mode, and icon appearance.
  • Maintenance: Clear your cache, or reload content.

Uncategorized Options[]

Immediately below the header there are three uncategorized options: Skills, Stats, and Achievements.

Rogue Skills iOS.PNG


The Skills option allows you to do two things: use your skills, and use Transformation Items on yourself and/or party members.

To use either, simply tap on the "Skills" option in the menu, then on the skill or item you want to use. The skills are located at the top, and the transformation items are below them.

If the mana cost of a skill is greyed out, that means you do not have enough mana to cast that skill, and will not be able to use it until you get enough. In the example to the right, the Rogue has enough mana to use Pickpocket, but not Backstab, Tools of the Trade, or Stealth.

Note: If you have been transformed and wish to un-transform, you can purchase the necessary potion at the bottom of the Rewards tab.

App iOS stats.png


The "Stats" option allows you to view your current stats, with a detailed breakdown of whether the points are coming from your level, your equipment, your buffs, or points you've allocated to that stat. It also allows you assign un-allocated points manually, or choose to enable/disable auto-allocation.

If you choose to enable auto-allocation, a brief list of method options will appear. Each option will have a little (i) next to it, and tapping on that will give you a brief explanation of how that method works.

Below the breakdown of stats is a detailed stats guide explaining the effect of each stat.

App iOS achievements.png


The "Achievements" option allows you to see all the Habitica achievements, whether you've earned them or not. Ones that you have earned will show the badge, and ones you have not yet earned will have a question mark inside a grey circle, as shown for the E-I-E-I-O achievement in the image to the right.

The default view is a list with details about what each badge requires, but you can switch to a grid view by tapping the four squares in the upper right of the screen.

Achievements which can be (and have been) gotten multiple times will have a number in a grey bubble overlapping the badge on the upper left. The explanation and/or title of the Achievement will also indicate how many times it's been earned, eg "Celebrated 4 Habitica Birthday Bashes!"

Social Category[]

The Tavern, Party, Guilds, and Challenges sections can be accessed from under the Social heading.

IOS Tavern.jpg


The Tavern has two tabs at the top: "Details" and "Chat."

  • The Details tab has multiple sub-sections 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."
  • The Chat tab has a real-time chat available to any Habitica player who wants to chat about pretty much any topic.
IOS Dysheartener.jpg

World Boss
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
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."

Tavern community guidelines.png

Community Guidelines
This section links to the Community Guildelines, 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
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.

IOS party.jpg


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.

Ios guilds.jpg


The "Guilds screen has two tabs at the top: "My Guilds" and "Discover".

  • In the "My Guilds" tab you can see a list of all the guilds to which you belong. Once you select one of them you can read and respond to guild messages, and participate in guild challenges.
  • In the "Discover" tab you can browse through and join public guilds by tapping on the option at the bottom, "Public Guilds".

You cannot use the app to create a guild.

IOS Public Challenges.png


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[]

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.


Ios shops menu.jpg

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[]

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.

A view of the Equipment menu on the iOS 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.

If you scroll all the way down your items page, you can see the quest scrolls that you currently own.


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.

FullSizeRender (4).jpg

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[]

Gems & Subscription screen on the iOS app.

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[]

The last section of the menu allows you to check the News, view Habitica's FAQ, and get information "About" your app.


The latest News, as reported by Bailey on the Website, can be found here.

Help & FAQ[]

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[]

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![]

If information is not displaying correctly in your app, or you are unable to perform a function as expected, please try the following steps.

  1. Check that you have the latest version of the app at the Apple Store.
  2. Ensure that the app has the latest item data by going to Menu > Settings > Maintenance > Reload Content.
  3. Clear your cache by going to Menu > Settings > Maintenance > Clear Cache.
  4. 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.
  5. If all the steps above fail, report the bug in the iOS app under Menu > About > Report a Bug or by emailing admin@habitica.com. The first option is preferred as it automatically captures your device information and the report is sent directly to the developer to analyze. It is sent in the form of an email, with your app version and User ID, and a space for you to write your report to the app developers. The second option will not include the useful debugging information about your account. Only use this method if the app will not allow you to send the iOS bug report directly through the Menu > About > Report a Bug. Be sure to describe the problem you are experiencing before sending a Bug Report email.