Resolve NuGet dependency conflicts
Package families are groups of Optimizely NuGet packages that relate to each other and release 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 are part of the same family, and they depend directly and indirectly on the EPiServer.Framework package.
When Optimizely releases a package family version, release notes and bug fixes are documented with the family name, not individual packages. The feature or fix you need could be in any package in the family, so update them together. Typically, updating one or a few top-level dependencies, such as the EPiServer.CMS package, resolves the rest automatically. If you encounter dependency conflicts, see the sections below.
📘 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 the packages that belong to each 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