Habitica Task Adjustor (v0.8)

Please wait. Fetching data from Habitica...

There was an error obtaining your data.

  • Please reload the page and then check that your User ID and API Token are correct.
  • If you're using Internet Explorer, try another browser. Chrome or Firefox will be more reliable.
  • If the page's URL starts with "http://" change it to start with "https://" (or just use this correct link).
  • If neither of those help, contact me! See "Help and Contact Details" at the bottom of this page.

Version History

0.8 2020-06-24
  • Feature:
    • Replaced Display Name with Username in header.
0.7.1 2020-04-25
  • Code:
    • Added x-client header.
0.7 2017-06-10
  • Bug fix:
    • Tasks from group plans no longer show editing controls for fields that can't be edited.
0.6 2017-06-08
  • Bug fix:
    • Working out if a Daily is due is now done with Habitica's isDue property and so will always give the same result as you see on the official mobile apps. If you see that the website is displaying a different selection of due Dailies, the website will be correct; please report it in the Report a Bug guild so we can fix the mobile apps.
0.5 2016-04-24
  • Feature:
    • Added a notification that tells you when a bug might be affecting sorting in your account (example message). If the bug doesn't affect you, you won't see any part of that message.
  • Bug:
    • Fixed (I think) a bug that was totally messing up tags on your task when you changed a tag with this tool.
  • Code:
    • Updated for API v3.
0.4 2016-04-24
  • Bug fix:
    • Allow challenge tasks to have their attributes changed (STR, PER, etc).
  • Documentation:
    • Removed most of the warnings about how this tool might damage your data. It's been safe for all the time I've been using it.
0.3 2016-04-23
  • Feature:
    • Enable markdown.
0.2 2016-04-11
  • Bug fix:
    • Prevented challenge tasks being edited to change their attribute, difficulty, and start/due date. Completion status (Dailies only) and tags can still be changed.
0.1 2016-04-10
  • Features:
    • Several, all experimental.
close version history (or click the version number again to close)

show explanation

Before using this tool, it's recommended to first you export your data to a backup file using the Habitica website's Data > Export Data > User Data > JSON feature and then afterwards, check that your changes are correct in Habitica. If any problems occur, email lady_alys@oldgods.net for help.

The table below shows your tasks (Habits, Dailies, To-Dos, and Rewards) with some of their settings.

Click on any setting that is underlined like this to see buttons for changing it. As soon as you have clicked on a button, the change will be sent to Habitica. For challenge tasks, most settings can't be changed.

When a task has been changed, its background will change to this colour. This indicates that the other information presented for that task might now be incorrect. For example, if you change the Start Date for a Daily, the "due today" field will probably be incorrect. Filtering will also not use the new information. To see correct data, use the "Re-Fetch Data" button at the top of the page. However, you don't have to fetch data immediately - you can first edit other fields for that task.

Dates: When typing a date, use the format yyyy-mm-dd. In future, there will probably be a calendar picker.

Sorting: Click on a column heading to sort the table by that column. Then, hold down your shift key and click on other column headings for a multi-column sort. The starting sort order is the order of your tasks in Habitica.

Filtering: Use the drop-down menus to filter the list. Select multiple items from one menu to filter for tasks matching any of those items (widen the filter). Select items from a different menu to narrow the filter. Click on the blue links that you'll see after you've chosen a filter to remove that filter.

Searching: Type words in the search box to show only tasks containing all of those words. This is not just for task titles; you can search on any field. The words do not have to be consecutive. Examples:

hide explanation

This page displays your Habitica tasks and allows you to modify some of their settings. It's intended for when you want to make similar changes to several tasks at once.

After logging in, click on the "show explanation" link to learn how to use the features. Some of them work in ways that aren't obvious!

If you have a lot of tasks, the page might not become responsive until a few seconds after login.

Enter your Habitica API details (from User Icon > Settings > API on the website or Settings > API on the Android app or Settings > Account Details on the iOS app)

Privacy and security notes:

  • If you modify your information on this page, your changes will be saved to your Habitica account.
  • Your API Token is a password - do not share it with anyone, not even the maintainer of this page if you are seeking help.
  • When you enter your User ID and API Token here and click "Fetch My Data", your ID and Token are sent to Habitica's servers. They are not sent anywhere else. To confirm that, you can ask someone who knows the JavaScript programming language to examine the source of this page.
  • This page does not save your User ID and API Token to any location, but your browser might, if it has been configured to save form and password information. If you are using this page on a shared computer, you should clear any data that the browser has saved.
  • You cannot view anyone else's data by using this page.
  • To clear your data, close or reload the page.

Help and Contact Details

This page has been created by Alys (a.k.a. Alice Harris). If you have questions, problems, or suggestions, you're welcome to contact me, although I cannot guarantee that I'll always be able to spend a lot of time on this. Email to lady_alys@oldgods.net is the best way to reach me.

If you have general questions about Habitica, post them to the Newbies guild (it's not just for new users!)

hide documentation