Resolve NuGet dependency conflicts

Package families are groups of Optimizely NuGet packages that are related to each other and are released together. They share the same version number and depend strictly on other packages within the same family. For example, the EPiServer.CMS.AspNetCore.HtmlHelpers package and the EPiServer.CMS.Core package is part of the same family, and they depend (indirectly and directly) on the EPiServer.Framework package.

When Optimizely releases a package family version, release notes and bug fixes are documented with the family's name and not the individual packages. This means that the feature or fix you are looking for may be in any package in the family, and you should update them together to get the benefits. Usually, this only requires updating one or a few top-level dependencies, like the EPiServer.CMS package and the rest resolve automatically. If you run into issues with dependency conflicts, read more in this article.

📘

Note

See also: NuGet package families in CMS.

The following sections show package families as they are named in the release notes and bug list, with a list of the packages that belong to the family:

EPiServer.CMS.Core

These packages are for Optimizely Content Management System (CMS).

• EPiServer.CMS.AspNetCore
• EPiServer.CMS.AspNetCore.HtmlHelpers
• EPiServer.CMS.AspNetCore.Mvc
• EPiServer.CMS.AspNetCore.Routing
• EPiServer.CMS.AspNetCore.TagHelpers
• EPiServer.CMS.Core
• EPiServer.Framework
• EPiServer.Framework.AspNetCore
• EPiServer.Hosting

EPiServer.CMS.UI

These packages are for Optimizely Content Management System (CMS).

• EPiServer.CMS.UI
• EPiServer.CMS.UI.Admin
• EPiServer.CMS.UI.AspNetIdentity
• EPiServer.CMS.UI.Core
• EPiServer.CMS.UI.Settings
• EPiServer.CMS.UI.Sources
• EPiServer.CMS.UI.VisitorGroups

EPiServer.Commerce

These packages are for Optimizely Commerce Connect.

• EPiServer.Commerce
• EPiServer.Commerce.Core
• EPiServer.Commerce.UI
• EPiServer.Commerce.UI.Admin
• EPiServer.Commerce.UI.CustomerService
• EPiServer.Personaliztion.Commerce
  (This is listed under EPiServer.Commerce release but follows a separate major version cadence.)
• EPiServer.Tracking.Commerce
  (This is listed under EPiServer.Commerce release but follows a separate major version cadence.)

EPiServer.Find

These packages are for Optimizely Search & Navigation.

• EPiServer.Find
• EPiServer.Find.Blocks
• EPiServer.Find.Cms
• EPiServer.Find.Cms.AttachmentFilter
• EPiServer.Find.Framework
• EPiServer.Find.Personalization

📘

Note

EPiServer.Find.Commerce is released and versioned separately.

EPiServer.ContentDeliveryApi and EPiServer.ContentManagementApi

These packages are for the Optimizely Content Management System (CMS) application programming interface (API).

• EPiServer.ContentDeliveryApi.Cms
• EPiServer.ContentDeliveryApi.Commerce
• EPiServer.ContentDeliveryApi.Core
• EPiServer.ContentDeliveryApi.Forms
• EPiServer.ContentDeliveryApi.Search
• EPiServer.ContentDeliveryApi.Search.Commerce
• EPiServer.ContentManagementApi