Version Specific Upgrade Notes

Version specific documentation for upgrading to new major versions of Umbraco Forms.

This article provides specific upgrade documentation for migrating to Umbraco Forms version 16.

If you are upgrading to a minor or patch version, you can find the details about the changes in the Release Notes article.

Version Specific Upgrade Notes History

Version 16 of Umbraco Forms has a minimum dependency on Umbraco CMS core of 16.0.0. It runs on .NET 9.

Breaking changes

Version 16 contains a number of breaking changes. If you do run into any, they should be straightforward to adjust and recompile.

For reference, the full details are listed here:

Removed EPPlus dependency

Previous versions of Forms depended on EPPlus version 4, the last LGPL-licensed release, which is no longer supported. Newer versions require a commerce license, which is not desired for built-in Forms features (such as exporting form entries to formatted Excel files). The built-in export now uses CsvHelper to generate CSV files instead.

Legacy version specific upgrade notes

You can find the version specific upgrade notes for versions out of support in the Legacy documentation on GitHub.