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).

Sort by distance

If your listing contains a proximity facet and you want to allow users to sort by distance, create a new sort option and set its data source to post__in with ASC order.

When proximity is active, the post IDs are automatically sorted (nearest to furthest).


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.