Packages [expand] [collapse]
Released in version

Release notes for Episerver updates

This overview lists changes included in Episerver updates delivered as NuGet packages and services. Use the information to decide which updates to apply to your project, see Installing Episerver updates. Select a product or package, and filter for dates, features, or bug fixes.

  • See only new features (all features) - filter on item type Feature.
  • See only end-user (user interface) features - filter on item type UI Feature.
  • See only critical bug fixes - filter on item type Critical Bug.

Note: New NuGet packages listed here may not be immediately available in the Episerver NuGet feed.

Changes in EPiServer.ContentDeliveryApi

Item type
From date
To date
Id Type Title Released
  Remove v3 APIs

Since we have backported the features from v3 to v2 the only remaining difference is a little difference in json format. However since we use options to control the behavior for other things we could add an option to control the json format as well and remove v3.
This would make code simpler, QA life simpler.

Version/s: EPiServer.ContentDeliveryApi 2.17.0;
Oct 07, 2020
  update headless api to return the RoutedBranch header

A delivery client will need to know which branch the request URL is mapped to. Just using the content branch will result in incorrect behavior when a fallback or replacement language is used.
We should extend the content resolving request to return this information as well.

Acceptance requirement

The client must get request branch information when the requested branch is inconsistent with the returned content
The ASP.NET Core site should use the Request branch rather that the Content branch to set the SiteContext and initialize the View localization.

Implementation notes

Getting the branch is easy when the host is mapped to a specific branch.
For unmapped hosts, we will need to call the router directly or extend the UrlResolver.Route to return additional information.

Version/s: EPiServer.ContentDeliveryApi 2.14.0;
Jul 23, 2020
  datetime out of range for generate etag for get site endpoint

OutputCache does not work with several time zones (e.g US - EST + 5) due to the DateTime.MaxValue is exceed.

Version/s: EPiServer.ContentDeliveryApi 2.14.0;
Jul 23, 2020
  Maintain requested language - handling content areas
  1. Given a specific piece of content (the page) is requested through the REST API with a specific requested language
  2. Language of the response (content language) is resolved based on requested language, available translations as well as fallback and replacement rules for the page.
  3. All expanded properties should try to match the content language, to return a single consistent translation.
  4. All links should try to match the requested language
Version/s: EPiServer.ContentDeliveryApi 2.14.0;
Jul 23, 2020
  Null reference error in ContentDependencyPropagator

When trying to startup a new commerce site the migration step fails because of event handler registered by ContentDependecyPropagator

2020-06-24 13:02:53,480 [1] ERROR EPiServer.Commerce.Internal.Migration.MigrationProgressMessenger: Migration step "Set catalog root access rights" failed with error: System.NullReferenceException: Object reference not set to an instance of an object.
at EPiServer.Core.Internal.ContentCacheKeyCreator.CreateChildrenCacheKey(ContentReference contentLink, String languageID)
at EPiServer.ContentApi.Core.OutputCache.Internal.ContentDependencyPropagator.ContentSecuritySaved(Object sender, ContentSecurityEventArg e)
at System.EventHandler`1.Invoke(Object sender, TEventArgs e)
at EPiServer.ChangeApproval.UI.Implementation.SecuritySettingCommandService.Save(IContentSecurityRepository contentSecurityRepository, ContentReference contentReference, IContentSecurityDescriptor contentSecurityDescriptor, SecuritySaveType securitySaveType)
at EPiServer.ChangeApproval.UI.Implementation.SecuritySettingIntercept.Save(ContentReference ContentLink, IContentSecurityDescriptor contentSecurityDescriptor, SecuritySaveType securitySaveType)
at EPiServer.Commerce.Internal.Migration.Steps.SetRootAccessControlEntriesStep.Execute(IProgressMessenger progressMessenger)
at EPiServer.Commerce.Internal.Migration.MigrationManager.MigrateStep(IMigrationStep migrationStep)

Version/s: EPiServer.ContentDeliveryApi 2.13.0;
Jul 08, 2020
  Return absolute canonical URLs from Content Delivery API
  • All internal content links are returned as absolute URLs using the canonical schema, host, and path configured for the site and branch of the linked content.
  • Content located outside of any site uses the default CMS logic to determine the current site.
  • Resolving the canonical URL is language-aware.
Version/s: EPiServer.ContentDeliveryApi 2.13.0;
Jul 08, 2020
  Media URLs should use management host

Media URLs in the REST API now use the management/edit host. This ensures images in XHTML properties, link item, collections, URL properties are fetchable in scenarios when the primary host is a separate application, such as some headless scenarios.

Version/s: EPiServer.ContentDeliveryApi 2.13.0;
Jul 08, 2020
  CDN OutputCache API

Output Cache features have been added for Content Delivery API:

  • ETag and Cache-Control header added to the response of each endpoint.
  • New option to configure output cache expiration time added.
Version/s: EPiServer.ContentDeliveryApi 2.11.0;
Jun 02, 2020
  CD searching of Commerce catalog content

A new package, CD.Search.Commerce, allows the searching of Commerce catalog contents using Episerver Find Commerce and the Content Delivery Api.

Version/s: EPiServer.ContentDeliveryApi 2.10.0;
Feb 13, 2020
  Allow more options for CD

1. Add more options and configuration for CD so the client can customize it easier. Basically, ContentApiOptions now will have four new options:

  • ValidateTemplateForContentUrl: Enable/Disable the validation of content url. For example, this option should be set to 'false' in case client want to get url of a content folder
  • FlattenPropertyModel: If this option is set to true, the response JSON will be flattened.
  • IncludeNullValues: If this option is set to false, the JSON serializer will ignore all null values in the response.
  • IncludeMasterLanguage: If this option is set to false, the response model of content will not contain the MasterLanguage property.

2. Support local block:

  • When a page/content contains a local block and client requests this page in CD, the response model will include this block information.
Version/s: EPiServer.ContentDeliveryApi 2.9.0;
Dec 23, 2019
1 2 3 4 5 6 Next