Configuring the sorting options for a Results List component

From the edit view of a Results List component, you can configure whether end users can change the sort order for the list.

To configure the sorting options for the component:

  1. On the edit view, under Sort Options:
    Initial view of the Sort Options section of the Results List edit view
    • To allow end users to set the sort order, check the Enable end user sorting controls checkbox. The box is checked by default.
    • To not allow end users to control the sort order, uncheck the checkbox.

    The Sort Options section is updated to reflect your selection.

  2. If the Sorting checkbox is not checked, then end users cannot change the list sort order. The Sort Options section contains a single field.
    Sort Options section of the Results List edit view with end user sorting off but no sort attribute selected

    To determine how the results list is sorted, drag an attribute from the Available Attributes list to the Sort Options field.

    In the Available Attributes list, you can use the filter field to find the attribute you want to use.

    After you drop the attribute, to determine the sort order:
    • To sort by the selected attribute in ascending order, click the up arrow. This is the default.
    • To sort by the selected attribute in descending order, click the down arrow.
    Sort Options section of the Results List edit view with end user sorting off and the sorting attribute selected

    To remove the attribute, click the delete icon.

    To replace the attribute with a different attribute, drag a different attribute from the Available Attributes, and then drop it on top of the currently selected attribute.

  3. If the Sorting checkbox is checked, then the Sort Options section is updated to allow you to provide a list of attributes end users can use to sort the list.
    Sort Options section of Results List edit view with end user sorting on but no attributes selected

    To add an attribute, drag the attribute from the Attributes List to the Sort Options table.

    In the Available Attributes list, you can use the filter field to find the attribute you want to use.

  4. To determine the order of the attributes in the Sorted by drop-down list, drag each row up and down in the list.
    Sort Options section of the Results List edit view with end user sorting on and attributes selected
  5. For the attribute you want to use for the default sort order:
    1. Click the Default radio button next to the attribute.
    2. To sort by that attribute in ascending order, click the up arrow.
    3. To sort by that attribute in descending order, click the down arrow.
  6. From the Sort Description drop-down list, select the text that displays next to the attribute in the Sorted by list.
    Sort Description drop-down list on the Results List edit view

    For each attribute, the Sorted by drop-down list includes one entry for sorting in ascending order, and one for sorting in descending order.

    Top left of Results List end user view showing the Sorted by drop-down list

    To create your own descriptions for ascending and descending order, from the Sort Description drop-down list, select create custom description. On the Create Custom Description dialog box:

    Create Custom Description dialog box for the Results List
    1. In the first field, marked with the up arrow, type the text to use to indicate ascending order.
    2. In the second field, marked with the down arrow, type the text to use to indicate descending order.
    3. Click Save.
  7. To remove an attribute from the list, click the delete icon for that attribute.