Optimizely Forms for CMS 13
Overview of breaking changes and migration steps for upgrading to Optimizely Forms 6.0.0.
Optimizely Forms 6.0.0 is a major version release that targets Optimizely Content Management System (CMS) 13 and .NET 10. The release aligns Forms with the CMS 13 platform, modernizes its configuration and dependency injection model, and removes a large set of APIs that have been deprecated since earlier versions.
ImportantOptimizely Forms 6.0.0 is not designed to work with Experience. You must migrate to CMS 13 before upgrading to Forms 6.0.0.
What changed
The following are the most significant changes in this release:
- Explicit DI registration – Services are no longer auto-registered. You must call
services.AddForms()inProgram.cs. - Configuration moved to
appsettings.json– The legacyForms.configXML file is removed. All settings are now configured under theFormskey inappsettings.json. - Removed deprecated APIs – Interfaces, methods, and classes marked
[Obsolete]in earlier versions have been removed, includingIEPiServerFormsCoreConfig,IExcludeValidatorTypes,ActiveExternalFieldMappingTable, and severalFormBusinessServiceoverloads. System.Text.JsonreplacesNewtonsoft.Json–PropertyGenericList<T>now usesSystem.Text.Jsonwith camelCase naming. Custom model types that rely onNewtonsoft.Jsonattributes require updates.- CMS 13 API alignment – Scheduled jobs, property definition types, and other platform APIs are updated to their CMS 13 equivalents.
See Breaking changes in Optimizely Forms 6.0.0 and Migrate to Optimizely Forms 6.0.0.
Updated 1 day ago