2026 Search & Navigation release notes
7 min
Subscribe to updates on this page using the notification and RSS feed options. Product packages are found on the Optimizely NuGet server.
Note
Are you looking for release notes before January 2024? See the Optimizely Release Notes on the Optimizely World site.
You can find prior versions of user guides and when functionality was released or deprecated at the following locations:
October 27
EPiServer.Find 17.1.0
Enhancement
- Added the GreaterThan and LessThan extension methods for long and nullable long fields. Use them to filter with an open lower or upper bound without using sentinel values. See Numerical for information about filtering numerical fields.
Bug fixes
- FIND-4106 – Fixed an issue where filtering with the In method threw an exception when the value list contained a null entry. Null values are now ignored, and matches are returned for the remaining values.
- FIND-12876 – Fixed an issue where downloading search statistics as a CSV file returned only 100 records. The download now returns up to 5,000 records. The statistics dashboard still displays 100 records.
- FIND-13268 – Fixed a validation error that occurred when you created a best bet with an external link that contained a query string or a fragment, such as https://www.test.com?a=123.
- FIND-14364 – Fixed an error that occurred when displaying click-through rate in search statistics for sites that use custom click tracking.
- FIND-15623 – Fixed an issue where ContentAreaConverter set a nested content area to null before reaching maxDepth when a content property name ended in Items, such as LineItems.
- FIND-15631 – Fixed an issue after upgrading to 17.0.1 where importing connectors, related queries, synonyms, and autocomplete items failed.
- FIND-15683 – Fixed an issue after upgrading to 17.0.2 where the Best Bets list and Boosting Preview displayed non-ASCII characters, such as å, ä, and ö, and the characters &, <, and > as HTML entity codes.
- FIND-15684 – Fixed an issue where the evented content event indexing queue in EPiServer.Find.Cms could terminate the application process when the host had already disposed its service provider. FIND-15685 – Fixed the issue where setting IndexQueueInterval to 0 enabled the content event indexing queue but never processed it. A value of 0 now pauses the queue, and EPiServer.Find.Cms logs a warning. FIND-15696 – Fixed the issue where search requests repeated type names in the type filter, which made requests unnecessarily large.
- FIND-15700 – Fixed an issue on sites with multiple instances where the content event indexing queue could index outdated content, including outdated access rights. The queue now removes queued content from the local cache and reads it from the database before indexing. This adds database load when you reindex a large branch, for example when you apply access rights to all subpages. Single-instance sites can turn this behavior off by setting EPiServer:Find:Cms:DisableIndexQueueLocalCacheEviction to true. The default is false. FIND-15767 – Fixed the issue where event-based indexing stopped with a SqlException about QUOTED_IDENTIFIER after the 17.0.2 upgrade. This happened when the content event indexing queue stored procedures had QUOTED_IDENTIFIER OFF. The database schema update in this release replaces the filtered RetryCount index on the index queue table with a standard index. FIND-15791 – Fixed the issue where indexing content with a large or deeply nested related content tree used too much processor time and memory. In some cases, indexing failed with out-of-memory exceptions.
September 8
EPiServer.Find 17.0.2
Bug fixes
- FIND-15478 – Fixed an issue where the content indexing job threw an exception instead of retrying after a transport-level failure. Connection resets, timeouts, and DNS or TLS errors carry no HTTP status code, and the retry logic failed while reading it. IndexWithRetry now treats a missing status code as transient, reduces the batch size, and retries.
- FIND-15537 – Fixed an issue where Languages.GetSupportedLanguage intermittently threw NullReferenceException or InvalidOperationException under concurrent load. The list of supported languages is shared across the process and was rebuilt while requests read it. The list now uses copy-on-write, and the local language refresh runs once per interval.
- FIND-15562 – Fixed an issue where SQL deadlocks (error 1205) occurred in the findIndexQueueSave stored procedure during bulk content publishing. The issue affects version 17.0.1 only, regardless of the version you upgrade from, and could stop large imports. The stored procedure no longer takes key-range locks, and a filtered index on RetryCount prevents a full table scan on each poll of the content event indexing queue. Upgrading to 17.0.2 runs a database schema update that applies the change.
- FIND-15580 – Fixed an issue where the /find_v2/_track and /find_v2/_click endpoints returned HTTP 404. Clicks on search results were not recorded in search statistics. The endpoints were missing after version 17.0.1 replaced the proxy with controller-based routes. Both are registered again as public endpoints.
August 4
EPiServer.Find 17.0.1
Enhancements
- Hardened the Search & Navigation admin API – Replaced the internal proxy endpoints that forwarded requests to the search backend with dedicated, access-controlled endpoints, so administrative operations can only perform the actions the admin interface exposes. All admin views (Explore, Best Bets, Synonyms, Connectors, Statistics, and Index Management) and public site features (autocomplete, spellcheck, and did-you-mean) continue to work without changes.
Bug fixes
- FIND-4177 – Fixed an issue where the indexing queue used GetHashCode() to generate the database key that identifies queued items. Because that value is not stable across application restarts or between servers in a load-balanced environment, it could cause key collisions that led to duplicate or missing indexing-queue entries. The queue now uses a deterministic hash to identify items.
- FIND-5833 – Fixed a ProjectionException (To deserialize objects the $type property must be set.) that occurred when a search projection selected a property with a nested collection type, such as List<List<string>>.
- FIND-15319 – Fixed an error that occurred when a search projection used AsCropped() on a field whose cropped text was formatted like an ISO 8601 date (for example, 2025-10-20T08:09:53). The cropped value is now always returned as a string.
- FIND-15389 – Fixed an issue where removing large amounts of filtered content (content excluded from indexing by a ShouldIndex convention) could return HTTP 429 (Too Many Requests) errors, because each item was deleted in a separate request. Filtered content is now deleted in bulk batches.
June 30
EPiServer.Find 17.0.0
Enhancements
- Improved attachment indexing to reduce memory use. Search & Navigation now streams attachment content to the index instead of holding each file in memory during serialization, which lowers memory use and garbage collection pressure when you index large files. Added the AttachmentSizeWarningBytes option (default 50 MB), which writes a trace warning when an attachment exceeds the threshold, so you can find oversized files before they slow indexing.
- Improved sorting on unmapped fields so that sorting on a field that does not exist in the index no longer returns an HTTP 500 error. Search & Navigation resolves the field type automatically, including for nested sorts, and orders documents that lack the field according to the SortMissing setting.
- Added warnings for large or slow content serialization. Search & Navigation now writes trace warnings during indexing when content takes too long to serialize, has a property that exceeds a size threshold, or has high serialization depth. This helps you optimize problematic content types before they affect production indexing performance. Configure the thresholds with the SerializationTimeWarningMs, SerializationSizeWarningBytes, and SerializationDepthWarningThreshold options in FindOptions.
- Added the $$type suffix to all indexed property types for Elasticsearch 2.x compatibility, which prevents mapping conflicts when two properties share a name but have different types. See Breaking changes for Optimizely Search & Navigation 17 for more information.
Important
You must perform a full data re-index after you upgrade to EPiServer.Find 17.0.0 due to the addition of $$type to all indexed property types.
Bug fixes
- FIND-4106 – Fixed an issue where filtering with the In method threw an exception when the value list contained a null entry. Null values are now ignored, and matches are returned for the remaining values.
- FIND-12803 – Fixed an issue where searchable text in inline blocks was not captured in the SearchText property, because inline blocks have no content reference.
- FIND-13989 – Fixed an issue where the Best Bets list failed to load with an HTTP 404 error in the Search & Navigation UI on .NET 9 and .NET 10. Also fixed a missing favicon on Search & Navigation pages.
- FIND-14580 – Added a ReIndexAsync method to ContentIndexer that uses IndexAsync instead of the synchronous Index method, so custom indexing jobs can run fully asynchronously.
- FIND-15107 – Fixed an issue where indexing jobs used too few parallel threads on multi-core servers. The IndexingJobMaxThread default is now 0, which lets Search & Navigation determine the thread count from available processors. Set a value greater than 0 to override it.
- FIND-15108 – Fixed an issue where the serialization pipeline allocated excessive memory and increased garbage collection pressure during indexing, which could degrade performance under heavy load.
- FIND-15205 – Fixed an issue where a query with leading or repeated whitespace returned an HTTP 500 error when using UsingSynonyms(). Whitespace is now collapsed to a single delimiter before the query is processed.
- FIND-15283 – Fixed an issue where authenticated users could not search content available to the Everyone role unless it was explicitly configured. The Everyone role is now added to RolesWithReadAccess for authenticated users.
May 26
EPiServer.Find 16.8.0
Enhancements
- Added management of statistical autocomplete phrases in the Search & Navigation UI. Statistical phrases are suggestions that Search & Navigation generates automatically from site visitors' previous successful searches. This lets you edit or delete those phrases from the Autocomplete tab to remove inappropriate or unwanted terms from the suggestions shown to site visitors.
- Added pagination to the Explore view in the Search & Navigation UI. The Explore view loads indexed content one page at a time instead of retrieving every indexed item at once. This reduces load on the search service and the UI and removes the repeated background search requests that the previous behavior generated.
- Updated the default maximum indexing depth for content areas to three levels. Search & Navigation limits the depth of nested ContentArea mappings to three levels by default, which protects search performance and cluster stability for sites that have deeply nested content structures. Override the default with the MaxDepthContentAreaConverter convention if your site requires a different depth.
Bug fix
- FIND-15111 – Fixed an issue where the Search & Navigation menu did not display, and Search & Navigation features stopped working when a site used a custom relative path instead of the default EPiServer path. Search & Navigation no longer overrides the configured user interface and protected module paths during initialization.
March 3, 2026
EPiServer.Find 16.7.1
Enhancement
- Added support for Search and Navigation for Content Management System 12 sites with Opti ID enabled. See Configure Opti ID for CMS 12 for more information.
Bug fixes
- FIND-14387 – Fixed a performance issue that caused excessive CPU and memory consumption during content indexing. The system now uses a pre-compiled static Regex instance to reduce processing overhead.
- FIND-14641 – Fixed an issue where items in the event indexing queue were not automatically removed after reaching the maximum retry count (default 10).
- FIND-14642 – Fixed an HTTP 500 error that occurred when filtering on a $$string field with a null value. The proxy now substitutes null string values with empty strings, and the .NET client ignores filters with null values.
- FIND-14951 – Fixed a PdfDocumentFormatException error that occurred during PDF attachment text extraction due to an outdated PdfPig library version.