---
title: Personalized Search & Navigation 2 breaking changes
slug: cms-12/docs/personalized-search-navigation-2-breaking-changes
docTags: 
createdAt: 2026-08-10T15:55:57.000Z
---

Version 2.0 of Optimizely Personalized Search & Navigation adds support for `EPiServer.Personalization` 2.0. See `EPiServer.Personalization` [breaking changes](docId\:aK-Nw4tFmYsWTQfz-7nCj).

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

## Configuration changes

See [Personalization.Commerce 2.0 breaking changes](https://docs.developers.optimizely.com/recommendations/docs/personalization-commerce-2-breaking-changes) and [Personalization.Commerce 3.0 breaking changes](https://docs.developers.optimizely.com/recommendations/docs/personalization-commerce-3-breaking-changes)