Release notes

Get an overview of the changes and fixes in each version of Umbraco Workflow.

In this section, we have summarized the changes to Umbraco Workflow that were released in each version. Each version is presented with a link to the Workflow issue tracker showing a list of issues resolved in the release. We also link to the individual issues themselves from the details.

If there are any breaking changes or other issues to be aware of when upgrading, they are also noted here.

Check the Version Specific Upgrade Notes article for breaking changes when upgrading to a new major version.

Release History

This section contains the release notes for Umbraco Workflow 17, including all changes for this version.

17.1.1 (March 2 2026)

• Fixes a bug where content scheduling via workflow approval could result in a key conflict exception, causing workflow initiation to fail #132

• Fixes Document Type filtering in Content Review configuration. A Document Type should be considered valid if it is not an Element, and has at least one property #131

17.1.0 (February 19 2026)

• Improves culture variation handling in email template generation

• Improves culture variation handling when scheduling release/expiry via workflow approval

• UI improvements for approval group workspace

• Adds missing email translations

• Introduces RazorLight for email template rendering. This fixes rendering issues when running in a hosted service in Production runtime mode.

• Fixes a bug where fallback email templates were not being detected and assigned (if the requested culture template did not exist)[#128] (https://github.com/umbraco/Umbraco.Workflow.Issues/issues/128)

17.0.2 (December 19, 2025)

• Fixes a bug where email templates were not compiled, resulting in emails failing to send #124

• Fixes async blocking code in email body generation

• Fixes a bug where changes to Document Type variance prevented updating properties on an alternate version

17.0.1 (December 11, 2025)

• Fixes a bug where removing document approval steps did not persist the changes #122

• Fixes a bug where the request-approval action was not displaying for new documents, where the new-document approval workflow had been configured #121

• Fixes a bug where adding an approval group would result in an error due a failing key-to-id map #120

• Fixes a bug where deleting content or document types did not complete correctly due to a missing scope #119

17.0.0-rc (November 7, 2025)

• Compatibility with Umbraco 17-rc.

• Introduces granular permissions model.

• Updates all persistence operations to use scoped transactions.

• Moves Workflow settings from /workflow to /settings. This change allows users to access /workflow without exposing low-level settings.

• Updates all DateTimes to UTC, in line with changes made in the CMS.

Legacy release notes

You can find the release notes for versions out of support in the Legacy documentation on GitHub