Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Indexes

Describes search indexing in Optimizely Configured Commerce.

Types of search indexes

Search IndexRebuild Option
ProductQuick Rebuild (Partial) and Full Rebuild
Include Rebuild Dynamic CategoriesIncludes the rebuilding of dynamic categories along with the full product rebuild
Include Rebuild Restriction GroupsIncludes the rebuilding of the restriction groups along with the full product rebuild
ContentFull Rebuild
CategoryFull Rebuild

The Indexing page, found in Marketing > Search > Indexing, provides access to the search indexes, their status, and the option (for product only) to perform a Quick (Partial) Rebuild or Full Rebuild. A Quick Rebuild only updates product records that have changed at the base level, which does not include changes to the product's child items, such as category or attribute assignments; a Full Rebuild re-indexes all products, including their child items.

When to rebuild and index

Rebuilding an index is necessary whenever changes are made to a respective content area. In most circumstances, modifying product records requires the Product Search Index to be rebuilt. Changes to products or child objects (categories, attributes, and so on) display on the website correctly without a re-index because they are loaded even after a search. However, new changes are not searchable until indexed. When adding a product/removing a product from a category, or adding/removing an attribute, those type of relational changes do not appear until after reindexing. Ultimately, it depends on if the changes are made to searchable content, and if it is important for new search terms to work immediately.

Another consideration is the amount of time it takes to complete a rebuild. Depending on the number of products, running a Full Rebuild can take quite some time. Running a Quick Rebuild takes considerably less time to complete. Therefore, it is worth the effort to be strategic in flagging products whose child objects are modified frequently with the Schedule for Quick Indexing option. These products will then always be included in the Quick Rebuild, even if the base product is not updated.

Add a product to the quick rebuild

To flag a product manually, go to the Product and select the More Options button and select Schedule for Quick Indexing.

Rebuild status notifications

When rebuilding an index, the Admin Console provides rebuild status notifications. These notifications happen both on the Indexing page, as well as notifications that display below the Breadcrumb, which are visible across the Admin Console. These notifications allow users to continue working and not remain on the Indexing page. The Indexing page notifications provide the indexing status, as well as a link to the Index Job. The date line of the notification serves as the link to the related job history. The Job page provides important information about the job, which can be especially helpful for troubleshooting.

Examples of Status Notifications

This example shows both a notice that a rebuild has started and that one has completed. Both of these notifications were received while viewing the Indexing page.

These examples show the rebuild statuses which are displayed via theSearch>Indexingpage:

This example shows both progress and error messages displayed within the Jobs menu. Clicking either of these jobs will open the related Details page to provide more information.

In rare cases where two or more products in a search have the same score or short description that results in a tie in sorting priorities, enable this setting to use the product number as a tiebreaker.

  1. Go to Administration > System > Settings in the Admin Console.
  2. Search for Enable Product Number Tiebreaker.
  3. Set the toggle to Yes. If yes, search results will be sorted by product number to handle ties in the search term results when the relevance score is identical.
  4. Click Save.