HomeDev GuideRecipesAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

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.

🚧

Important

Optimizely 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() in Program.cs.
  • Configuration moved to appsettings.json – The legacy Forms.config XML file is removed. All settings are now configured under the Forms key in appsettings.json.
  • Removed deprecated APIs – Interfaces, methods, and classes marked [Obsolete] in earlier versions have been removed, including IEPiServerFormsCoreConfig, IExcludeValidatorTypes, ActiveExternalFieldMappingTable, and several FormBusinessService overloads.
  • System.Text.Json replaces Newtonsoft.JsonPropertyGenericList<T> now uses System.Text.Json with camelCase naming. Custom model types that rely on Newtonsoft.Json attributes 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.