Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
49 lines (27 sloc) 1.92 KB

Side-by-Side indexes

This feature enables you to create an index that will be replaced by another one after one of the following conditions are met:

  • new index becomes non-stale (non-optional)
  • new index reaches last indexed etag (in the moment of creation of a new side-by-side index) of a index that will be replaced (optional)
  • particular date is reached (optional)


As you probably know, making any changes in index definition will reset its indexing state and indexing process will start from scratch. This situation can be troublesome when you need to update index (assuming that changes are backward compatibile) on production server without having your application display partial results (due to index reset). This is why side-by-side indexes were introduced.


using AbstractIndexCreationTask

{CODE side_by_side_1@Indexes\SideBySide.cs /}


{CODE side_by_side_4@Indexes\SideBySide.cs /}

using DocumentStore

{CODE side_by_side_2@Indexes\SideBySide.cs /}

{INFO: Execution of multiple side by side indexes} Side by side indexes are created as a single request when overloads for multiple indexes are used. {INFO/}


{CODE side_by_side_3@Indexes\SideBySide.cs /}


  • first you need to edit index. In our example we are picking Orders/Totals and we are adding ShipVia field.

Figure 1. Side-by-Side. Index Edit.

  • finally, when index definiton is ready, you need to save index as Side-by-Side using action bar. The popup will appear with the name of an index that will be replaced and a list of replacement conditions.

Figure 2. Side-by-Side. Index Edit. Definition. Change

Figure 3. Side-by-Side. Index. Popup.

Related articles