OpenProject is the leading open source project management software.
Release date: 2024-04-24
We released OpenProject 14.0.0. The major release contains several bug fixes, and we recommend updating to the newest version. In these Release Notes, we will first list important technical updates, then give an overview of important feature changes. At the end, you will find a complete list of all changes and bug fixes.
Starting with OpenProject 14.0, docker images will be published to openproject/openproject on Docker Hub. If your setup is still using the old image name (openproject/community), you will need to update your configuration to use the new image names.
All previous images have been pushed there as well, so you can simply update your configuration to use the new image name ahead of your update.
In the relations API, the attribute delay
has been renamed to lag
. This change is to align the API with the terminology used in project management and the UI. For more information, see #44054.
In version 13.1 we have overhauled our system to handle internal permission checks by allowing permissions to not only be defined on project or global level, but also on resources like work packages. Therefore, we have introduced new methods to check permissions. The old methods have been marked as deprecated and are now removed in 14.0.
Affected methods are:
User#allowed_to?
User#allowed_to_globally?
User#allowed_to_in_project?
If you have developed a plugin or have custom code that uses these methods, you need to update your code to use the new methods. For more information, see #51212.
We have changed the number and naming of the configurable design variables. This simplifies the process of setting the desired color scheme for users. It also allows us to get closer to the Primer design system in order to benefit from its other modes such as the dark mode or the colorblind mode in the future.
The following variables have been changed:
Old name | New name | Notes |
---|---|---|
primary-color | primary-button-color | Was merged with the previous "alternative-color". The value of "alternative-color" was kept. |
alternative-color | primary-button-color | Was merged with the previous "primary-color". The value of "alternative-color" was kept. |
primary-color-dark | - | Will now be calculated automatically based on the "primary-button-color" |
link-color | accent-color | Is not only used for links, but for all decently highlighted elements (e.g. the selection state in a datepicker). The (old) value of "primary-color" was use for this. |
If you have developed a plugin or have custom code that uses these variables, you need to update your code to use the new names. The rest of the variables is unchanged. For more information, see #53309.
The model_changeset_scan_commit_for_issue_ids_pre_issue_update
hook has been removed completely. This was made necessary as the code around it was not making use of the proper update mechanisms (Service objects) which lead to inconsistencies in the data, i.e. ancestor work packages. For more information, see #40749.
Since the done_ratio is now a read only value, derived from work and remaining work, the commit_fix_done_ratio
setting has been removed. For more information, see #40749.
available_responsibles
from the APIThe available_responsibles
endpoint has been removed from the API. This endpoint was used to retrieve a list of users that could be set as the responsible for a work package. This information has been identical to the results by the available_assignees
endpoint. When you are using the available_responsibles
endpoint in your application, you should switch to using the available_assignees
endpoint instead.
There are some major changes in terms of progress reporting for work package hierarchies. The calculation of progress (% Complete) in work package hierarchies is now consistent. This leads to the following important changes:
In Work-based progress reporting, % Complete will be automatically calculated and can therefore no longer be edited manually. This means that for a work package to have a value for % Complete, both Work and Remaining work are required to be set. To make this link clear and transparent, clicking on any of the three values to modify them will display the following pop-over:
In Status-based progress reporting mode, Work is not a required value. However, if Work is set, Remaining work is automatically calculated. To make this link clear and transparent, clicking on any of the three values to modify them will display the following pop-over:
Admins are able to exclude specific work packages (e.g., those marked as rejected) from the total sum calculations of their parent. In this case, a small info icon will appear next to excluded values:
In addition to these changes, the section 'Estimates and Time' has been renamed to 'Estimates and Progress' and this is where you will now find % Complete. Also, the seeding of statuses has been fixed to include % Complete values and in the Progress modal, you will now be able to preview changes amongst the fields live.
Please note that regarding progress reporting, updating to OpenProject 14.0 might result in automated data modification in certain cases. See our blog to learn about the details and motives on these significant changes to progress and work estimates and how it might affect you.
With OpenProject 14.0, you are now able to view and edit custom fields for projects in a structured way, organized in sections, on the project overview page. These fields are now referred to as 'Project attributes'. Admins can edit them directly on the project overview page:
Project attributes as well as the sections can be managed in administration/projects/project attributes.
Until now, there have been uncertainties with project-specific custom fields from time to time. This is why the tab 'project' has been removed from the custom fields admin settings pages. Instead, project custom fields are now edited within their own admin settings page. Also, the custom fields widget has been removed.
As described above, project custom fields are now called 'Project attributes' and can be shown in a sidebar on the project overview page on a per-project configuration.
OpenProject's (Dynamic) Meetings have been updated with the following new features:
With OpenProject 14.0, admins now get email notifications when a file storage (e.g. Nextcloud) is unhealthy. To avoid sending unwanted messages, we also added the option to deactivate these health status notifications for a storage.
Read more about file storage troubleshooting in our documentation.
If you copy a project where a file storage has automatically managed project folders selected, you will now have the following options:
As of 14.0, admins are asked whether they also want to remove access to shared work packages when removing a project member or group from a project.
The team planner allows for easy planning of users assigned to work packages. It is now possible to have the team planner span more than two weeks, with newly added options for 4-week and 8-week timeframes.
As mentioned in the earlier blog post about the Primer Design System, work is ongoing to unify more and more components of the application to match this design. In 14.0, we have started to add new primer-based page headers.
Apart from the features mentioned above, there have been a lot of other changes, smaller features and, of course, bug fixes for OpenProject 14.0:
A very special thank you goes to our sponsors for features and improvements of this release:
Also a big thanks to our Community members for reporting bugs and helping us identify and provide fixes. Special thanks for reporting and finding bugs go to:
Silas Kropf, Philipp Schulz, Benjamin Rönnau, Mario Haustein, Matt User, Mario Zeppin, Romain Besson, Daniel Hilbrand, Christina Vechkanova, Sven Kunze, Richard Richter, Julian Wolff
Last but not least, we are very grateful for our very engaged translation contributors on Crowdin, who translated quite a few OpenProject strings! This release we would like to highlight user izzahk who has done an outstanding number of translations for the Malaysian language in recent weeks.
Would you like to help out with translations yourself? Then take a look at our translation guide and find out exactly how you can contribute. It is very much appreciated!
Release date: 2024-03-26
We released OpenProject 13.4.1. The release contains several bug fixes and we recommend updating to the newest version.
A big thanks to community members for reporting bugs and helping us identifying and providing fixes.
Special thanks for reporting and finding bugs go to
Romain Besson, Ricardo Vigatti, Bình Trần
Release date: 2024-03-20
We released OpenProject 13.4.0. The release contains several bug fixes as well as great new features and we recommend updating to the newest version.
Read more about the new features and see an overview as a list of all bug fixes and changes at the end of these release notes.
The release contains various new features and improvements:
We are delighted about the GitLab integration, which is officially available with OpenProject 13.4. It goes back to the plugin that Community contributor Benjamin Tey created 3 years ago. Many thanks at this point to everyone who worked on the GitLab integration and the plugin – inside and outside of OpenProject's core development team! Such projects are a great example of the power of open source collaboration.💙
With this integration, you can manage GitLab's units of work (merge requests and issues) from within OpenProject by linking them with work packages. Read more about OpenProject's GitLab integration in our system admin guide.
Already using the user-generated GitLab plugin? With OpenProject 13.4, the existing plugin will be replaced by the new integration. We recommend removing the plugin module folder and bundler references before upgrading to OpenProject. Your historical dataset will remain unaffected within OpenProject as there were no changes to the data model.
Before upgrading, please do the following:
Bundler::GemfileError
matching the following error message: Your Gemfile lists the gem openproject-gitlab_integration (>= 0) more than once.
rm -rf /path/to/openproject/modules/gitlab_integration
With OpenProject 13.4 we are again releasing further features for custom project lists. The most important update here is that you can now modify the selection and order of columns, then save them in a newly configured view, much like how you typically manage a work package list.
In addition, you will now be reminded to save changes to your project list in the form of a Save link in the top right corner. This helps users remember to save the view and not lose their work when they leave the page.
We also worked intensively on the Meetings module for 13.4: From now on, you can also attach files (e.g. images) to OpenProject's dynamic meetings. This will look like this, for example:
Another long-awaited improvement: When you copy a dynamic meeting, existing agenda items are now also copied. This saves a lot of time and work for recurring meetings.
And finally, the .ics file now also contains information about the (dynamic) meeting attendees - in addition to other existing information such as PARTSTAT. This now allows you to confirm or decline invitations to a meeting directly in your calendar software.
Stay tuned: Further advanced features for our Meetings module are planned for upcoming releases – take a look at this EPIC for detailed information.
Another important step towards data security: With OpenProject 13.4, users' uploaded files can be scanned for viruses, using the ClamAV antivirus engine. To do so, a new attachment menu item is created with Antivirus settings. Read more about virus scanning using ClamAV in our system admin guide.
Admins are now shown an intermediate loading modal during the OAuth nudge follow when the redirect to the storage provider takes time.
Accessibility functionality: Convey to screenreaders when OAuth login has started, while it's in progress, and when it's completed or failed.
OpenProject version 13.4 now supports PDF exports with lists in table cells that are displayed correctly. Export a work package that contains a table with lists in it into a PDF. Here is an example of how this looks from now on:
Two-factor authentication (2FA) is a key factor in data security. With OpenProject 13.4, OpenProject offers a new method as a second factor. You can now use hardware tokens such as Yubikeys, browser or password manager passkeys that use the WebAuthn/FIDO/U2F standards.
Thanks to our great Community we can continuously offer more languages for OpenProject. With OpenProject 13.4, users now have over 50 languages at their disposal. Previously there were less than ten, which is a considerable step forward. Please note, however, that only a few languages are officially reviewed and updated by OpenProject. This currently applies to English, German, French and Spanish. Regarding all other languages, we ask for your patience and thank all Community contributors from the bottom of our hearts.
A very special thank you goes to our sponsors for features and improvements:
Another big thanks goes to our Community members for reporting bugs and helping us identify and provide fixes. Special thanks for reporting and finding bugs go to Andreas H., Diego Liberman, Andreas G, Mario Zeppin, Arved Kampe, and Richard Richter.
We are always thankful for our great Community. If you are thinking about contributing to OpenProject yourself, we would like to encourage you to do so!
An important part is also the translations, for which we thank the following contributors in particular for this release:
Would you like to help out with translations yourself? Then take a look at our translation guide and find out exactly how you can contribute. It is very much appreciated!
Release date: 2024-02-28
We released OpenProject 13.3.1. The release contains several bug fixes and we recommend updating to the newest version.
A big thanks to community members for reporting bugs and helping us identifying and providing fixes.
Special thanks for reporting and finding bugs go to
Dennis St.
Release date: 2024-02-14
We released OpenProject 13.3.0. The release contains several bug fixes and we recommend updating to the newest version.
In addition to other changes, OpenProject version 13.3 includes the following three important features:
One major change is the relocation of the Gantt views to a separate module. Please note that with OpenProject 13.3 all saved work package queries (private or public) with an activated Gantt view moved to the new Gantt charts module.
You can navigate to the new Gantt chart module either via the side menu in a project or via the global menu:
The view button from the work package module is now only present in the BIM version of OpenProject and only for switching from the list to the cards view.
OpenProject has enhanced the project filter list view and now lets you create custom project lists by saving your preferred filter settings. Please note that in future releases, the project lists will be further improved and additional features will be added.
With this release, admins of an Enterprise edition can choose between manually or automatically managed project folders. If you select the latter, all project members are automatically granted access to the project folder.
See our blog to learn more about features we included in OpenProject 13.3. You can find a detailed list of all new features and bugfixes below.
A very special thank you goes to our sponsors for features and improvements of this release:
We also want to thank our Community members, particularly James Neale, TARIQ YASIN, Jeff Li, Christian Jeschke, Sreekanth Gopalakris, Jörg Mollowitz, Sven Kunze, Steffen Kirschke, and Valeria Aguzzi for reporting bugs and helping us identify and provide fixes.
A big thank you to every other dedicated user who has reported bugs, supported the community by asking and answering questions in the forum and provided translations on CrowdIn.
Release date: 2024-01-31
We released OpenProject 13.2.1. The release contains several bug fixes and we recommend updating to the newest version.
A big thanks to community members for reporting bugs and helping us identifying and providing fixes.
Special thanks for reporting and finding bugs go to
Pawlik Wini, Arved Kampe, Thomas Wiemann, Jeffrey McDole, Tom Gugel, Oleksii Borysenko, René Schodder, Sreekanth Gopalakris, Various Interactive, Kajetan Ignaszczak
Release date: 2024-01-17
We released OpenProject 13.2.0.
Among other features, it brings improvements for the OneDrive/SharePoint integration, now also allowing Manual project folders. In addition to that, both OneDrive/SharePoint and Nextcloud integrations were improved by showing deleted files in OpenProject work packages.
We also added the option to filter the project member list, allowing project administrators to easily filter through the project member lists based on various roles, groups and shares. Instance administrators can now also allow for users to change work package status without the rights to edit a work package.
Furthermore, it is now possible to set users with whom a work package has been shared as assignee or responsible. The quick content menu in the Gantt view has now offers an additional option to show work package relations.
Finally, several fields were renamed:
As always, this release contains several bug fixes and we recommend updating to the newest version.
With OpenProject 13.2, manual project folders have become available for OneDrive/SharePoint storage, further improving access to essential project files.
When project folders are configured, all project-related files are automatically uploaded and organized within the specified folder. To activate project folders, administrators are required to designate the desired folder as the project folder and manually configure the associated permissions. This feature enhances user convenience and file organization within the OpenProject environment.
See our user guide to learn more about this Enterprise add-on and how to use the SharePoint integration.
In 13.2 we improved the functionality of file storages. Even if a file has been deleted on a file storage, it will still be displayed under the Files tab in OpenProject work packages, allowing users to better keep track of project files.
This new feature is available for both file storage integrations.
With OpenProject 13.2, users can filter the list of project member based on user roles, groups, and shared work packages. This enables project members to promptly identify others with specific roles or individuals outside the project team who have gained access through the newly introduced Sharing feature.
Read more about filtering the project members list in our user guide.
In OpenProject 13.1, we introduced the work package sharing feature with external users. In the 13.2 release, these shared users can now be designated as assignee and accountable for the work packages that have been shared with them. This is useful for teams collaborating with external partners who cannot access sensitive project data but still require access to specific tasks within the project.
Learn more about our Sharing work packages (Enterprise add-on).
In OpenProject 13.2, the ability to modify the status of a work package is now separated from the broader "Edit work package" permission. This separation means that a user can be granted the right to change the status without having the permission to edit the entire work package.
Read more about roles and permissions for users of OpenProject.
Quick context menu in the Gantt view now includes "Show relations" option. It displays all existing relations for the selected work package.
Please note that this option is only available if you have selected a Gantt view (i.e. not a table or cards view).
Read more about Gantt charts in OpenProject
Several field names were changed in OpenProject 13.2.
Furthermore, the calculation of Work and Remaining work has been modified, now featuring a sum value (∑) displayed in the "Work" and "Remaining work" fields. This sum shows the total value of all child elements within the work package, including the work package itself.
Please note that % Complete does not adjust automatically when the values of Work or Remaining work are changed.
A very special thank you goes to our sponsors for features and improvements of this release:
A big thanks to Community members for reporting bugs and helping us identifying and providing fixes, especially to Arun M, Patrick Massé and Richard Richter.
A big thank you to every other dedicated user who has reported bugs, supported the community by asking and answering questions in the forum and provided translations on CrowdIn.
Release date: 2023-12-22
We released OpenProject 13.1.2. The release contains several bug fixes and we recommend updating to the newest version.
Release date: 2023-12-20
We released OpenProject 13.1.1. The release contains several bug fixes and we recommend updating to the newest version.
A big thanks to community members for reporting bugs and helping us identifying and providing fixes.
Special thanks for reporting and finding bugs go to
Tom Gugel, Marek Krempa
Release date: 2023-12-13
We released OpenProject 13.1.0.
It brings significant enhancements in our Meetings module and various minor adjustments, such as the integration of Primer design system and the introduction of a high contrast mode to enhance OpenProject's accessibility.
For enterprise users, two additional features have been introduced to streamline workflow efficiency within OpenProject: the capability to share work packages externally and the debut of a OneDrive/SharePoint integration.
As always, this release contains several bug fixes and we recommend updating to the newest version.
You probably already know OpenProject's Meetings module. Formerly, this module restricted users to creating meeting agendas in a single text block. OpenProject 13.1 enables the creation and management of individual agenda items. This includes creating direct links to specific meetings from a work package and provides a comprehensive overview of the discussions and links directly to the meeting associated with the work package.
This feature, designed with the latest Primer UI components and UX patterns, is funded by the German Federal Ministry of the Interior and Home Affairs (BMI) as part of the openDesk project.
Please note: The already existing classic meetings will be removed with one of the upcoming releases and only the new dynamic meetings will remain. Migrations will be provided.
See our user guide to learn more about the updated meetings module and how to use it.
OpenProject already offered the file sharing integration with Nextcloud. However, we recognized that some customers use other document storage solutions, such as Microsoft SharePoint. This is why, alongside the already existing integration with Nextcloud, OpenProject 13.1 brings the new file sharing integration with OneDrive/SharePoint as an Enterprise add-on. This feature allows you to easily upload, link, and access SharePoint files directly from your work packages.
See our user guide to learn more about this Enterprise add-on and how to use the SharePoint integration.
With OpenProject 13.1 it is possible to share work packages with users and/or groups outside of your installation. This sharing feature is available as an Enterprise add-on. Work packages can now be shared with users or groups that have no permissions to see a particular project in its entirety, only allowing access to relevant work packages. This way, stakeholders can get easy access to relevant project information without having to see all of a project’s work packages.
See the user guide for instructions on how to use this new feature.
With OpenProject 13.1, we released Attribute help texts for the Community edition. This allows providing explanatory help text for all project attributes, such as status, accountable or any custom field. The help text will be displayed as a small question mark icon beside the attribute, simplifying the input process and helping to avoid mistakes.
We continued to work on improving accessibility of OpenProject according to the WCAG 2.1 AA. You can now select to use a high contrast mode in your profile settings, which will override the current OpenProject theme and be especially valuable for OpenProject users with visual impairments.
With OpenProject 13.1 we have continued to integration the Primer Design system. This will especially be noticeable in the new features, such as the new Meetings module.
Support for packaged installations on Centos7 and SUSE Enterprise Linux 12 have been removed in 13.1.0 Both are nearing or have exceeded their EOL and packaged builds were failing prior to the release already. We will not provide additional support for these systems.
Users still required to run on these systems should consider upgrading to a supported version, or use our docker-based installation methods.
For more information, please see #51333 and our installation guides.
admin
user, after an update two admin
users exists in the database. [#50208]A very special thank you goes to our sponsors for features and improvements of this release:
A big thanks to Community members for reporting bugs and helping us identifying and providing fixes:
Jeff Tseung, Richard Richter, Daniel Elkeles, Jörg Mollowitz, Christina Vechkanova, Sven Kunze, Jeff Li, Mario Haustein, Mario Zeppin.
A big thank you to every other dedicated user who has reported bugs, supported the community by asking and answering questions in the forum and provided translations on CrowdIn.