Disclaimer: This website requires Please enable JavaScript in your browser settings for the best experience.

HomeDev GuideAPI Reference
Dev GuideAPI ReferenceLegal TermsDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

Personalized Search & Navigation 2 breaking changes

Describes the breaking changes for Optimizely Personalized Search & Navigation 2.0 in relation to the previous major version 1.

Version 2.0 of Optimizely Personalized Search & Navigation adds support for EPiServer.Personalization 2.0. See EPiServer.Personalization breaking changes.

Because of breaking changes from EPiServer.Personalization, EPiServer.Find.Personalization does not provide settings related to the Personalization service. EPiServer.Personalization provides all settings. See Use scopes in a multisite installation.

API changes

EPiServer.Find.Personalization.Api.RefreshPreferenceCommand

The following properties and fields were removed from the RefreshPreferenceCommand:

  • BaseApiUrl
  • ClientToken
  • Site

To access these settings in the newer version, look at the RefreshPreferenceCommand's ScopeConfiguration property. This ScopeConfiguration instance contains the properties listed above.

EPiServer.Find.Personalization.Conventions.IPersonalizationClientConventions

The following properties and fields were removed from IPersonalizationClientConventions:

  • BaseApiUrl
  • ClientToken
  • Site

If you need to get these properties and fields in any custom implementation using the newer version, implement the GetPersonalizationConfiguration property. This property is a function that returns a PersonalizationConfiguration instance that has the GetConfiguration(scope) and GetConfiguration() methods. These methods return a ScopeConfiguration instance that contains the properties listed above. See Use scopes in a multisite installation.

Configuration changes

See Personalization.Commerce 2.0 breaking changes and Personalization.Commerce 3.0 breaking changes