Add a sort box for changing the listing order. Allows for defining the sort choices visually.

Available Options

Name Description
Default label The dropdown label that the user sees by default (i.e. when no sort has been selected)
Sort options The UI for customizing the choices that appear in the sort dropdown. Each row corresponds with a sort choice, allowing you to set:

(a) the label
(b) the name (i.e. what gets added to the URL)
(c) the sort criteria. Each criteria includes the field name and sort direction, and each row can actually contain multiple criteria. An example is if you wanted to add a fallback sort.

Sort options

The following example shows the setup for a sort box containing the default label of “Sort results” and 3 choices (Title DESC, Price DESC, and MPG Highest).


For numerical sorts like “Price”, the custom field should contain a raw integer or decimal value. Fields containing dollar signs, commas, or other symbols won’t work.

For date sorts, the field should contain values in YYYY-MM-DD, YYYYMMDD or YYYY-MM-DD HH:MM:SS format. The default “Post Date” and “Post Modified” fields use this format already. But if you’re using a custom field in some other format, it likely won’t work.