Per Bjurström
Aug 25, 2016
(9 votes)

Planned breaking changes 2016

An update to let you know what breaking changes are coming in CMS this year.

The main breaking changes are:

  1. A new state AwaitingApproval for content. We are also adding new events to IContentEvents and new save actions. Supports features around content approval.
  2. IContentRepository.Save and the events around that (IContentEvents) have a few quirks and odd behaviours that we have fixed to make the API more consistent and work better with approvals.
  3. Migration to UTC dates in the database will be a required step when upgrading, be ready by doing the migration today.
  4. Reviewed all APIs to make sure we do not expose implementation classes as part of our public versioned API. We will make a separate post about this with more details.

Some of the smaller breaking changes:

  • Links to unpublished content will return 404 (instead of login screen).
  • Localized texts will fallback to a fallback culture in the language files before falling back to values specified in code.
  • LanguageBranch class now implements IReadOnly to support read-only caching.
  • No longer possible to create sites without at least one host defined.
  • Properties PageData.StartPublish/StopPublish are changed to Nullable.
  • StartPublish will be null until published or set explicitly (today it defaults to the created date which is misleading).
  • Fixed confusing handling of empty properties (for example assigning an empty link item collection to a typed model resulted in a null value)
  • IContentVersionRepository List methods have been consolidated into one
  • The UI Framework EPiServer.Shell.dll will be moved from NuGet package EPiServer.Framework to EPiServer.CMS.UI.Core.

A lot more details will be provided as part of the release, including a list of all breaking changes and which APIs are being changed. Pre-release packages of the breaking change release will be made available as part of the continous release process in the coming weeks.

Aug 25, 2016


valdis Aug 27, 2016 10:51 PM

Changes for better :) Good work. Are you planning to jump to 10.x?

Aug 29, 2016 08:23 AM

Thanks, yes there will be a new major.

Johan Kronberg
Johan Kronberg Sep 4, 2016 04:55 PM

StartPublish changes sound great!

Please login to comment.
Latest blogs
Delete a content – the right way

I stumped upon this blogpost Delete content directly from the Optimizely database – Tomas Hensrud Gulla by Tomas, an OMVP. While the post is helpfu...

Quan Mai | Feb 8, 2023 | Syndicated blog

The Content Revolution - Generative AI

Hi Optimizely Community,  For the past two decades, you and Optimizely have been at the forefront of content management - creating, managing,...

Alex Atzberger | Feb 6, 2023

Delete content directly from the Optimizely database

Do you know your way around the Optimizely CMS database? Deleting, or updating, content directly in the database is pretty straightforward, but of...

Tomas Hensrud Gulla | Feb 6, 2023 | Syndicated blog

Rolling your site out to China

How to rollout your website to the China market Continue reading →

Andrew Markham | Feb 5, 2023 | Syndicated blog