Release Notes 17.6

docs/release-notes/17-6-0/README.md

@@ -3,28 +3,130 @@ title: OpenProject 17.6.0
 sidebar_navigation:
     title: 17.6.0
 release_version: 17.6.0
-release_date: 2026-06-18
+release_date: 2026-07-08
 ---
 
 # OpenProject 17.6.0
 
-Release date: 2026-06-18
+Release date: 2026-07-08
 
 We released [OpenProject 17.6.0](https://community.openproject.org/versions/2298).
 The release contains several bug fixes and we recommend updating to the newest version.
 In these Release Notes, we will give an overview of important feature changes. At the end, you will find a complete list of all changes and bug fixes.
+
 ## Important feature changes
 
-<!-- Inform about the major features in this section -->
+OpenProject 17.6 continues our vision of providing a comprehensive open source platform for project management and collaboration. The new XWiki integration brings project management and enterprise knowledge management closer together, while further improvements for Backlogs, Meetings, and administration help teams plan, collaborate, and execute their work more efficiently.
+
+Take a look at our release video showing the most important features introduced in OpenProject 17.6.0:
+
+![Release video of OpenProject 17.6](https://openproject-docs.s3.eu-central-1.amazonaws.com/videos/OpenProject_17_6_release.mp4)
+
+### XWiki integration (Enterprise add-on)
+
+[feature: xwiki_integration ]
+
+OpenProject 17.6 introduces a new integration with XWiki, enabling teams to connect project work and documentation more closely. Together, OpenProject and XWiki provide an **integrated open source solution** for organizations looking to manage both projects and documentation on their own infrastructure. This makes the integration a natural choice for existing XWiki users and for organizations looking to replace proprietary combinations such as Jira and Confluence with a sovereign open source solution. [Learn more about the motivation behind the integration and our collaboration with XWiki in our dedicated blog article](https://www.openproject.org/blog/x.wiki-integration).
+
+![OpenProject XWiki integration: Wiki providers overview with listed XWiki](openproject_system_administration_wiki_providers.png) 
+
+With the new integration, work packages now include a **dedicated Wiki tab** where users can view related wiki pages, create new pages, and link existing content from XWiki. This makes it easier to access relevant documentation directly from the work package where the work is planned and executed.
+
+The integration also supports **references between OpenProject and XWiki**. Users can see which wiki pages reference a work package and insert links to wiki pages directly from descriptions, comments, and documents. This helps teams keep project work and documentation connected across both platforms.
+
+![OpenProject XWiki integration: 'Wikis' tab in a work package, with a linked XWiki and a 'Referenced in' link to another XWiki page, and option to add a wiki](openproject_work_package_xwiki_tab_referenced.png)
+
+> [!NOTE]
+> OpenProject's built-in [wiki module](../../user-guide/wiki/) remains available and continues to be supported. In future releases, we also plan to further improve it. The XWiki integration is designed for organizations that require advanced wiki and documentation capabilities. It is available as an Enterprise add-on in the Corporate plan.
+
+### Sprint goals
+
+OpenProject 17.6 introduces sprint goals for Backlogs. When creating or editing a sprint, you can now define a sprint goal directly within the sprint settings.
+
+The sprint goal is then displayed on the sprint header, making it visible to everyone working on the sprint.
+
+![Edit sprint view with field to manually enter a sprint goal](openproject-17-6-sprint-goals.png)
+
+### All sprints overview
+
+OpenProject 17.6 introduces a new **All sprints** view in the Backlogs module. The new page provides an overview of all sprints in a project.
+
+For each sprint, the overview displays key information such as its status, start and finish dates, and the number of assigned work packages.
+
+![OpenProject Agile project, Backlogs module and 'All sprints' view with the following columns: Sprint name, Status (Completed or In planning), Start date, Finish date, Work packages (number included)](openproject-17-6-all-sprints.png)
+
+### Display backlog buckets in work packages
+
+OpenProject 17.6 introduces a new **Backlog bucket attribute for work packages**. If enabled for a work package type, users can view and manage backlog bucket assignments directly from the work package details.
+
+Work packages can now be assigned to backlog buckets without navigating to the Backlogs module. Since a work package can only belong to either a sprint or a backlog bucket, selecting one will automatically remove the other assignment.
+
+![User story work package in OpenProject with backlog bucket dropdown](openproject-17-6-backlog-bucket-work-package.png)
+
+### Group, sort and filter work packages by backlog bucket
+
+OpenProject 17.6 adds support for backlog buckets in work package tables. You can now add the Backlog bucket column to a work package table and use it to filter, sort, and group work packages.
+
+This makes backlog bucket assignments visible in work package tables, allowing teams to organize, filter, and analyze backlog items more effectively.
+
+![Work package table with highlighted Backlog bucket column](openproject-17-6-backlog-bucket-work-package-table-highlighted.png)
+
+### Support project-based (semantic) identifiers in exports
 
-## Important updates and breaking changes
+OpenProject 17.6 extends support for project-based (semantic) identifiers across exports. Semantic identifiers are now included consistently in:
+
+- Excel and CSV exports
+- Meeting PDF exports
+- Timesheet PDF exports
+
+This ensures that exported data uses the same identifiers that users see throughout OpenProject.
+
+### Unreserve old project-based (semantic) identifiers
+
+OpenProject 17.6 extends support for reserved project identifiers to project-based (semantic) identifiers. When a project identifier is renamed, previous identifiers remain reserved so that existing links and integrations continue to work.
+
+Administrators can now unreserve old project-based (semantic) identifiers and make them available for reuse by other projects.
+
+![Admin setting with a list of projects and their identifiers and an "Unreserve" button next to each](openproject-17-6-reserved-project-identifiers.png)
+
+### Convert meeting agenda items into work packages
+
+OpenProject 17.6 adds a new **Convert to work package** action for meeting agenda items. This allows users to turn agenda items directly into work packages without leaving the meeting.
+
+The newly created work package remains linked to the agenda item, helping teams connect meeting discussions with follow-up work.
+
+![Meeting with agenda item three dots (more) menu opened and option to "Convert to work package"](openproject-17-6-meeting-work-packages-highlighted.png)
+
+### Configure cost types per project
+
+OpenProject 17.6 introduces project-specific cost type configuration. Project administrators can now control which cost types are available within each project.
+
+To support this, project settings now include a new Time and costs section with a dedicated Cost types tab where available cost types can be configured.
+
+![Time and Costs setting in a project with Cost types overview](openproject-17-6-cost-types-project-setting.png)
+
+## Important technical changes
+
+### Escape control characters in CSV exports
+
+OpenProject 17.6 improves CSV export security by escaping control characters in exported data. This helps prevent spreadsheet applications from interpreting exported values in unintended ways.
+
+If you need to escape unmodified machine-readable CSV exports, you can disable this flag on the new Exports page Administration → System settings → Exports
+
+### Configure LDAP group synchronization using group member attributes (Enterprise add-on)
+
+[feature: ldap_groups ]
+
+OpenProject 17.6 extends LDAP group synchronization with support for group member attributes. Administrators can now configure synchronization based on attributes such as `member` or `uniqueMember` on LDAP groups, in addition to the existing `memberOf` lookup on user entries.
+
+This improves compatibility with LDAP servers that do not maintain the `memberOf` attribute. Read more about [synchronizing LDAP and OpenProject groups](Enterprise add-on)(../../system-admin-guide/authentication/ldap-connections/ldap-group-synchronization)
 
 ### Integrations (e.g. Nextcloud and XWiki) respect global SSRF filters
 
 To increase the security of OpenProject installations, we've added protections against server-side request forgery in previous releases
 of OpenProject. These prevent OpenProject from making network requests into private IP address space.
 
-Starting with OpenProject 17.6, these protections expand into the code that's responsible for web requests of storage and wiki integrations as well.
+Starting with OpenProject 17.6, these protections also apply to web requests made by storage and wiki integrations.
 This means if you have a Nextcloud instance or an XWiki instance reachable via a private (i.e. not publicly routable) IP address, you need to
 add it to the SSRF allowlist to be able to keep the integration working. This is usually achieved by defining the following environment variable:
 
@@ -36,7 +138,7 @@ The list accepts one or multiple IP addresses or ranges (in CIDR notation) that
 
 ### Meeting API structure changes
 
-17.6. introduces new endpoints for meeting outcomes,
+OpenProject 17.6 introduces new endpoints for meeting outcomes,
 and changes the self link for all meeting related resources to be flat:
 
 That means, some of the responses have changed:
@@ -191,11 +293,15 @@ This follows the APIv3 standards, and also fixes a bug related to the self link.
 <!-- Warning: Anything above this line will be automatically removed by the release script -->
 
 ## Contributions
-A very special thank you goes to our sponsors for 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 Rince wind, Walid Ibrahim, Gábor Alexovics, Brandon Soonaye, Mohammed Mohiuddin.
-
-Last but not least, we are very grateful for our very engaged translation contributors on Crowdin, who translated quite a few OpenProject strings!
-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!
+
+A very special thank you goes to Helmholtz-Zentrum Berlin, City of Cologne, Deutsche Bahn and ZenDiS for sponsoring released or upcoming features. Your support, alongside the efforts of our amazing Community, helps drive these innovations.
+
+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 Rince wind, Walid Ibrahim, Gábor Alexovics, Brandon Soonaye, and Mohammed Mohiuddin.
+
+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 particularly thank the following users:
+
+- [OlhaTrotska](https://crowdin.com/profile/olhatrotska), for a great number of translations into Ukrainian.
+- [Daniel Catarino](https://crowdin.com/profile/tradengport), for a great number of translations into Portuguese.
+- [Raffaele Brevetti](https://crowdin.com/profile/rbrevetti), for a great number of translations into Italian.
+
+Would you like to help out with translations yourself? Then take a look at our [translation guide](../../contributions-guide/translate-openproject/) and find out exactly how you can contribute. It is very much appreciated!