HomeGuidesAPI ReferenceGraphQL
Submit Documentation FeedbackJoin Developer CommunityOptimizely GitHubOptimizely NuGetLog In

Personalized Search & Navigation 2 breaking changes

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

Version 2.0 of Personalized Search & Navigation adds support for EPiServer.Personalization 2.0. For more information, see EPiServer.Personalization breaking changes.

Because of breaking changes from EPiServer.Personalization, EPiServer.Find.Personalization does not provide settings related to the Personalization service. All settings are provided by EPiServer.Personalization. For more information, see Using 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 new 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 new 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. For more information, see Using scopes in a multisite installation.

Configuration changes

For more information, see Personalization.Commerce 2.0 breaking changes and Personalization.Commerce 3.0 breaking changes


Did this page help you?