Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.uselayers.com/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Sort Orders determine the sequence in which products appear on collection pages. You can fine-tune product visibility using a combination of priority rules, product attributes, weighted attribute groups, and soft boost. These expressions help align product sorting with your marketing strategies and customer preferences.

Enable as storefront sort

When creating or editing a sort order, you can control whether it is synced to Shopify as a metaobject using the Enable as Storefront Sort toggle. This option is enabled by default, allowing sort orders to be referenced in Shopify’s admin and Storefront API. Learn more about how sort orders are synced to Shopify in Metaobjects & Metafields.

Sort order architecture

Sort Orders build upon the attribute foundation and can be enhanced with sequences, while being subject to merchandising rule overrides. For a visual overview of how sorting connects to attributes, sequences, and merchandising, see Sorting — Core Concepts. Sort Orders can also leverage segmented metrics to automatically personalize product rankings based on visitor context like geographic location or marketing channel.

Why sort orders matter

Sort Orders shape how products are presented on collection pages so shoppers find the right items faster. Use priority rules, attributes, and weighted groups to reflect your brand strategy and customer preferences. For step-by-step instructions, see:

Bulk actions

You can select multiple sort orders from the list and perform actions on them at once. To enter selection mode, click Select in the actions column header. Checkboxes appear next to each sort order row. Select the sort orders you want to act on, then open the Actions dropdown to choose an action.
Hold Shift and click a checkbox to select every row between the previous selection and the row you clicked. This works on every list in the dashboard that supports bulk actions, including sort orders, merchandising rules, and recommendation blocks.

Bulk duplicate

Select one or more sort orders and choose Duplicate from the Actions dropdown. Each selected sort order is copied with an auto-generated name and code to avoid conflicts. Duplicated sort orders default to unpublished and are not enabled as storefront sorts, so they won’t affect your live storefront until you configure and activate them.

Bulk delete

Select one or more sort orders and choose Delete from the Actions dropdown. A confirmation prompt appears before the deletion proceeds.
You cannot delete a sort order that is currently referenced by a merchandising rule, used by a product sequence, or has received API requests in the past 24 hours. If any selected sort order meets one of these conditions, the entire operation is blocked and an error message identifies the conflict.
When you are done selecting, click ActionsDone selecting to exit selection mode.

Reorder sort orders

The order in which sort orders appear on a collection page’s sort dropdown is controlled from the Sort Orders list. Open the overflow menu next to Browse Recipes and click Reorder to open the Reorder Sort Orders sheet. In the sheet:
  1. Drag any sort order row by its grip handle to reposition it.
  2. Use the keyboard arrow keys after focusing the grip to move a sort order up or down (useful for accessibility).
  3. Click Save to persist the new order, or Cancel to discard your changes.
The order you set here is the order shoppers see in the storefront sort dropdown for sort orders that have Enable as Storefront Sort turned on. Newly created sort orders are appended to the end of the list and can be repositioned at any time.
Reordering only affects display order. It does not change which sort order is the default for a collection — the default is still controlled by the merchandising rule that targets the collection.

Keyboard shortcuts in the editor

The sort order editor supports keyboard shortcuts to speed up authoring. Press ? while the editor is focused to open the Keyboard Shortcuts dialog at any time.
ShortcutAction
+S (Mac) / Ctrl+S (Windows/Linux)Save the sort order
+Z / Ctrl+ZUndo the last change
+Shift+Z / Ctrl+Shift+ZRedo the last undone change
?Open this shortcuts dialog
DragReorder expressions inside a sort group
ClickExpand or collapse an expression card

Best practices

  • Balance weights: Avoid extreme weight differences to ensure fair influence of attributes.
  • Monitor impact: Regularly review conversion rates and customer behavior to refine sorting strategies.
  • Use priority rules wisely: Use descending direction to promote products and ascending direction to demote them. Priority rules are always applied first as hard overrides — promoted products appear at the top and demoted products appear at the bottom, with other expressions sorting within those groups.
  • Leverage recipes: Start with pre-configured sort orders and customize them based on your specific merchandising goals.
  • Test configurations: Preview sort orders with different priority rule configurations to verify they produce the desired ranking. Use sort effect annotations to see exactly which rules affected each product.
For further details, see the Browse API or contact support.

See also