Sorting enables you to manage the order in which the entities appear within a vertical. There are two types of sorting: 

• Search Configuration Sorting - will change the order of results returned by the Search API
• Frontend Sorting - will provide UI controls for a user to sort results after they run a search

For example, for events, you may want to set the start time as sortable within the Search configuration. That will allow you to use the event start time field to sort event entities. To learn more about sorting, visit the Sorting (Backend) training unit.

To add Sorting in the UI:

1. Click Search in the navigation bar and click on the desired Search experience.
2. Click Verticals.
3. Click + Add Sorting Rule.
4. Click Select a Type and select the desired sorting option.
5. Select the settings based on the sorting option you selected.
   • If you selected Field as the sorting option, select the desired field in the Field column. In order for a field to be selected, you must select Sortable as an option in your Searchable Field configuration. 
   • If you selected Distance as the sorting option, select the desired Sorting Direction.
6. Once you have added all of your Sorting Rules, click Save.

To add Sorting using the JSON Editor:

1. Click Edit in JSON to navigate to your Search Configuration file.
2. Enable sorting via JSON within the searchableFields object.

   It should look something like this:

   "searchableFields": {
     "time.start": {
         "sortable": true
      }
    }

3. Then, in each vertical, use the "sortBys” property to set each sorting option.
   

   It should look something like this:

   "sortBys": [
     {
       "type": "RELEVANCE"
     },
     {
       "direction": "ASC",
       "field": "c_acceptingNewPatients",
       "type": "FIELD"
     }
   ],

Once you have set your sort rules in the backend, it can also be added to the frontend experience. The steps vary depending on your implementation method:

• Hitchhikers Theme: Sorting Frontend training unit
• Search SDK: SortOptions component

• Search Endpoints

• Search Core