Report a bug
If you find a bug please create a bug report.
- Login to or register at the OpenProject community platform. It’s fast and free.
- Look for an existing bug report using the search bar in the header navigation on top. If there’s one, please leave a comment or add additional information. Otherwise:
- Open the bug form.
- Add a precise subject.
- Add a detailed description using the template.
- Attach a file (optional).
- Press Create.
Information you should add to the bug description
Preconditions to reproduce the bug
Prior to detailing which steps to take to reproduce the error, the necessary preconditions which have to be met should be stated.
- Which browser did you use when you experienced the error?
- Do you receive any error messages in the browser console when the error occurs? Please include the error message if applicable.
- Please also include the contents of the browser’s developer tool’s network tab where applicable.
- If you are self-hosting please include logs from
sudo openproject logs
gathered while you are reproducing the error.
Example:
* Forum exists
* Forum messages exist with many replies
Steps to reproduce the bug
- The detailed steps that led to the bug should be listed in the description in order to replicate the bug and determine the underlying problem.
Example:
1. Go to forum
2. Scroll to bottom of messages
Actual behavior
- The actual, erroneous behavior should be stated briefly and concisely.
Example:
* Not possible to switch to next entry in pagination
Expected behavior
- If known, the expected behavior of the application should be described concisely.
Example:
* Possible to switch to next pagination page
Screenshots
- If applicable, a screenshot should be added to the bug report in order to explain the bug visually.
- The unintended behavior should be marked in the screenshot (e.g. by using red color).
- The screenshot can be attached as a file and can be integrated in the description with the following syntax: “!Name_of_screenshot.png!” (without quotation marks) (Notice: Name_of_screenshot should be replaced with the respective name of the file. The file ending (here: .png) has to be adjusted to the appropriate file type of the screenshot.)
Help and feedback
If you did not find what you were looking for
If you need help from the community or want to support others
If you are eligible for professional support and have more questions
REQUEST SUPPORT
If you find an easily fixable error or need for improvement in the documentation for the stable release
If you would like to suggest bigger updates or improvements to this documentation
If you want to contribute to translate this documentation to another language
If there's something you don't like or understand about this feature
If you want to propose a new feature that OpenProject does not offer yet
To further help OpenProject to shape and test new features
To view OpenProject premium features and pricing
If you want to try all premium features in the OpenProject Cloud Edition 14 days for free
If you want to try all premium features in your on premise Community installation 14 days for free