New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

How to Report an Issue - Read these Instructions Before Posting! #2760

deilann opened this Issue Feb 5, 2014 · 0 comments


None yet
2 participants
Copy link

deilann commented Feb 5, 2014

The easiest and best way to report a bug with the website or mobile apps is in Habitica's Report a Bug guild, available from the Help menu on the website (also from Guilds on the website or mobile apps).

Almost all bugs can be handled in that guild and there is usually no reason to create a GitHub issue.

In the rare cases when you need to log a GitHub issue, a moderator or staff member will advise you of that. Mods and staff have dark blue or purple names. If any other players suggest that you create a GitHub issue, please post to the Report a Bug guild instead.

To report a serious exploit affecting user privacy / security / finances:

If you find a bug in Habitica that affects the security or privacy or finances of players, please email and please don't mention the bug in any public location, as that would allow other people to use the exploit maliciously. Habitica will fix all exploits as rapidly as possible, and then will inform any players that might have been affected.

Other kinds of bugs are better reported in the Report a Bug guild described above, rather than by email. We can see your Habitica account immediately in that guild and so can usually fix your issue rapidly

To make a feature request / suggestion:

Feature requests or suggestions should not be made in GitHub nor in the Report a Bug guild. Instead, go to Help > Request a Feature from the Habitica website, which takes you to our Trello Board. We generally can't accept feature requests posted to GitHub because new ideas need to be considered along with existing ones to produce features that suit a range of players. Feature requests made in GitHub are almost always closed with a suggestion that the idea be copied to Trello.

To report a bug in the Android or iOS Habitica app:

Ensure that you are using the latest version of the app. If that doesn't fix the bug, report it in either the Report a Bug guild described above.

When a moderator or staff member asks you to create a new issue in GitHub:

  1. Sign up for a Github account, or sign in if you already have one. This will allow you to get an email update on any issue you create or respond to.
  2. Create a new issue by clicking here, or on the green "New Issue" button near the top right of the Issues page.
  3. Include your User ID. If you can access the website, go to User Icon -> Settings -> API to find it (it is a long string of random characters and is not the same as your Habitica name). If you can only access the mobile apps, you can find it under Settings > Account Details (tap on it to copy it to the clipboard). Do not tell us your API Token which is in the same location as the User ID but which must be kept secret.
  4. Include the other information requested on the new issue page (browser, operating system, etc).
  5. If the problem is related to a party or guild, also include the Group ID, which you can find on the party or guild page in the bottom of the left-hand column. Paste the ID as text, not screenshots.
  6. Include any JavaScript errors that may be displayed (see Chrome Console instructions for how to do that).
  7. Update us if you have any new info, or if the problem resolves itself!

To view known bugs

If you'd like to look through existing issues to see if your bug has been reported, view the most common issues first, and if you don't find a relevant one there, view all open issues. You can search by adding keywords to the "Filters" box then hitting enter on your keyboard. Often, a common issue will have bold text near the top telling you how to fix it, so you don't need to leave a comment. Note that even if you find an issue that's related to your situation, it's very often better for you to report it in the Report a Bug guild as described at the top of this page. We can usually handle bugs faster there because we can see your Habitica account immediately.

@deilann deilann closed this Feb 6, 2014

deilann added a commit that referenced this issue May 18, 2014

@Alys Alys referenced this issue Aug 19, 2014


A chrome bug #3890

@Alys Alys changed the title How to Report an Issue How to Report an Issue - Read these Instructions Before Posting! Sep 17, 2014

@HabitRPG HabitRPG locked and limited conversation to collaborators Sep 26, 2014

@HabitRPG HabitRPG unlocked this conversation Jan 26, 2015

@HabitRPG HabitRPG locked and limited conversation to collaborators Jan 27, 2015

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.