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 targets Optimizely Content Management System (CMS) 13 and .NET 10. Upgrade to this version to run Forms on the CMS 13 platform. This release modernizes configuration and dependency injection (DI) and removes APIs deprecated in earlier versions.
ImportantOptimizely Forms 6.0.0 does not work with Experience. Migrate to CMS 13 before upgrading to Forms 6.0.0.
What changed
Identify which areas of your project require updates by reviewing the following changes:
- Explicit DI registration – Forms no longer auto-registers services. Call
services.AddForms()inProgram.cs. - Configuration moved to
appsettings.json– TheForms.configXML file no longer exists. Configure all settings under theFormskey inappsettings.json. - Removed deprecated APIs – Interfaces, methods, and classes marked
[Obsolete]in earlier versions no longer exist. Removals includeIEPiServerFormsCoreConfig,IExcludeValidatorTypes,ActiveExternalFieldMappingTable, and severalFormBusinessServiceoverloads. System.Text.JsonreplacesNewtonsoft.Json–PropertyGenericList<T>usesSystem.Text.Jsonwith camelCase naming. Update custom model types that rely onNewtonsoft.Jsonattributes.- CMS 13 API alignment – Scheduled jobs, property definition types, and other platform APIs use 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
