---
title: Personalized Search & Navigation 2 breaking changes (legacy)
slug: product-recommendations/docs/personalized-search-navigation-2-breaking-changes
docTags: 
createdAt: 2026-07-30T20:41:30.719Z
---

Version 2.0 of [Personalized Search & Navigation](https://docs.developers.optimizely.com/platform-optimizely/docs/personalized-search-navigation) (legacy) adds support for EPiServer.Personalization 2.0.

See also EPiServer.Personalization [Personalization.Commerce 2 breaking changes](docId\:jpTxo729qWKoSvnfaQXQS).

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 information, see [Using scopes in a multisite installation](https://docs.developers.optimizely.com/commerce/v14.0.0-commerce-cloud/docs/multiple-scopes).

## 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](https://world.optimizely.com/documentation/developer-guides/commerce/personalization/recommendations/multiple-scopes/).