---
title: "Liquid filters: sort_by"
description: |-
  Generates a collection URL with the provided `sort_by` parameter appended.
  This filter must be applied to the object property [`collection.url`](https://shopify.dev/docs/api/liquid/objects/collection#collection-url).
api_name: liquid
source_url:
  html: https://shopify.dev/docs/api/liquid/filters/sort_by
  md: https://shopify.dev/docs/api/liquid/filters/sort_by.md
---

# sort\_​by

```oobleck
string | sort_by: string
```

returns [string](https://shopify.dev/docs/api/liquid/basics#string)

Generates a collection URL with the provided `sort_by` parameter appended. This filter must be applied to the object property [`collection.url`](https://shopify.dev/docs/api/liquid/objects/collection#collection-url).

Accepts the following values:

* `manual` (as defined in the [collection settings](https://help.shopify.com/manual/products/collections/collection-layout#change-the-sort-order-for-the-products-in-a-collection))
* `best-selling`
* `title-ascending`
* `title-descending`
* `price-ascending`
* `price-descending`
* `created-ascending`
* `created-descending`

***

Tip

You can append the `sort_by` filter to the [`url_for_type`](https://shopify.dev/docs/api/liquid/filters/url_for_type) and [`url_for_vendor`](https://shopify.dev/docs/api/liquid/filters/url_for_vendor) filters.

***

##### Code

```liquid
{{ collection.url | sort_by: 'best-selling' }}
```

##### Data

```json
{
  "collection": {
    "url": "/collections/sale-potions"
  }
}
```

##### Output

```html
/collections/sale-potions?sort_by=best-selling
```