---
title: "How-to sort products"
description: Here we show you how to sort a list of products by title, price etc. This allows you to get the results you desire.
url: "https://getaawp.com/docs/article/sorting-products/"
updated: "2018-02-13"
category: Functions
---

# How-to sort products

There might be a situation where you want to re-order a list of products by title, price etc. This can be done by using the shortcode attributes "order" and "orderby".

## Sorting examples and options

### Sorting products by title

In this example we assume you want to sort a list of products by title (from A to Z):

```
[amazon bestseller="smartphone" orderby="title" order="asc"]
```

*In case you want to sort the products in reverse order, change the order attribute to `desc`.*

### Sorting products by price

In this example we assume you want to sort a list of products by price (from highest to lowest):

```
[amazon bestseller="smartphone" orderby="price" order="desc"]
```

*In case you want to sort the products in reverse order, change the order attribute to `asc`.*

### Sorting products by price reduction

In this example we assume you want to sort a list of products by their price reduction (from highest to lowest):

```
[amazon bestseller="smartphone" orderby="percentage_saved" order="desc"]
```

*In case you want to sort the products in reverse order, change the order attribute to `asc`.*

---

### What shortcodes can be used for sorting?

Sorting can be applied when displaying [multiple boxes](https://getaawp.com/docs/article/product-boxes/), [bestseller lists](https://getaawp.com/docs/article/bestseller-lists/) and [new releases lists](https://getaawp.com/docs/article/new-releases-lists/).

---

### Overview of all available sorting options

#### "orderby" options

| Value | Description |
| --- | --- |
| `title` | Title of the product |
| `price` | Advertised price of the product |
| `percentage_saved` | Price reduction (in percentage) of the product |
| `amount_saved` | Price reduction (total amount) of the product |
| `rating` | Rating (numeric) of the product *Right now ratings cannot be guaranteed ([see this article](https://getaawp.com/blog/note-missing-star-ratings/)). That's why it's not recommended to order by rating.* |

#### "order" options

| Value | Description |
| --- | --- |
| `asc` | Ascending order (e.g. low to high or A to Z) |
| `desc` | Descending order (e.g. high to low or Z to A) |

---

## Advanced information

### Increasing the range of products for sorting

It's possible to sort an even larger number of products, but only display a lower amount of products. The benefit is, that the sorting can be applied to more products which might give you better results.

Therefore add the shortcode attributes `items` and `order_items` as follows:

```
[amazon bestseller="smartphone" orderby="price" order="desc" order_items="10" items="5"]
```

This way, the plugin fetches 10 products (instead of only 5) from the API and orders them by their price. Anyway, your list only shows a total amount of 5 products, but includes products that might not be included without making use of `order_items`.

 **Important note**: Due to the new Amazon API v5, the maximum amount of products returned is 10. That's why the attribute order_items is limited to 10 as well. More information about the new Amazon API can be found [here](https://getaawp.com/docs/article/amazon-product-advertising-api-v5/).   When passing a browse node id (bestseller and new releases only), the API only returns a maximum amount of 10 products. This also applies to *order_items*. In case you want to display or order more than 10 products, you have to forward a keyword instead of the browse node id. When increasing the range of products, the plugin needs to fetch, store and update more data than usual. We recommend only using the extra attribute if you're totally unhappy with the former results.