Add fields to the searchable field ranking list

To make a field searchable, it must be configured as searchable in the catalog and be a member of a searchable field ranking list.

This section applies to Open Storefront Framework (OSF) and Storefront Classic.

Follow these steps to add a field to a searchable field ranking list.

1. Click the Search icon in the dashboard.
2. On the Search page, click Searchable Field Ranking.
3. Click the searchable field ranking list to which you want to add a field.

   The searchable field ranking list displays index fields that are searchable. The order of the fields in the searchable field ranking list affects the ranking of search results. Fields higher up in the list have a greater ranking and search requests that match values in these fields appear first in your search results.

4. Under Add Field, select the index field that you want to add to the searchable field ranking list. You can also type the name of an index field in the box, and Commerce filters the list to match what you have typed. The match is not case sensitive.

   If you cannot find the field, you must find the associated property in the catalog, click “Allow property to be searched,” and then publish your changes. See Create and edit product types for more information. Note that it might be several minutes after publishing completes for the new index field to appear.

5. The field is added to the bottom of the list of index fields.
6. Click the field and then click and drag it to the position in the list that reflects its rank.
7. Click Save.

Changes to the searchable field ranking list do not affect your store until after you publish.

Configure cross-field matching

If cross-field matching is enabled for this searchable field ranking list, you can configure where you want cross-field matches to display in a list of search results. To learn more about cross-field matching, see Cross-field matching.

1. On the Search page, click Searchable Field Ranking.
2. Click the searchable field ranking list in which you want to configure cross-field matching.

   The searchable field ranking list displays a slider next to the list of index fields. If the slider is disabled you cannot configure cross-field matching. To enable cross-field matching, use the search REST APIs.

   Moving the slider handle up or down changes where cross-field matches display in your search results. Matches for index fields above the slider handle have a higher priority. These matches appear before any cross-field matches. The index fields below the slider handle have a lower priority than cross-field matches.

3. Move the slider handle up to give cross-field matches a higher priority, or down to give them a lower priority.
4. Click Save.