Skip to main content

Lists Overview

In this document, you’ll get an overview of lists in Medusa including filters, searching, and more!

Filter Items

You can use filters to retrieve only items in a list matching specific criteria.

Quick Filters

On a table with a list of items, you’ll find quick filters at the top of the list.

You can click on one of these filters to quickly apply it to the list of items.

https://i.imgur.com/eVwD0JP.png

Advanced Filters

You can use advanced filters to furthermore limit the items shown based on specific criteria. For example, on the Orders list, you can filter orders to only show pending orders created in a specific region.

To use advanced filters:

  1. Click on the plusplus icon next to Filters. This will toggle a dropdown with categories for different fields.
  2. You can click on a field name to expand it and choose a filter for that field.
  3. Click on the Apply button at the top of the dropdown.

This will retrieve the items based on the filters you’ve selected.

https://i.imgur.com/rg9nKcS.png

Save Advanced Filters as Quick Filters

If there are filters that you need to use frequently, you can give the set of filters a name and save them to be used later. For example, you can save the filters used in the previous example as “European Orders”.

To save an advanced filter:

  1. Click on the plusplus icon next to Filters.
  2. Choose your filters from the dropdown.
  3. Choose a name for the filters in the input at the end of the dropdown.
  4. Click the Save button.

https://i.imgur.com/0nKZ5BX.png

Once you click Save, you should see the new filter you added next to the Quick Filters at the top of the list.

https://i.imgur.com/ymuSHkv.png

To apply a saved quick filter, just click on it.

Delete Saved Quick Filters

You can delete any saved filter you’ve created. To do that, simply click on the XX icon next to the quick filter’s name, and it will be deleted.

Clear Filters

To clear all applied filters:

  1. Click on the plusplus icon next to Filters.
  2. Click on the Clear button.

https://i.imgur.com/ArawLDT.png

info

Clearing filters does not delete saved quick filters. You can still apply them by clicking on them.


Search Items

You can search for items in a list by clicking the magnifiermagnifier icon at the top right of the list.

https://i.imgur.com/Z09rbmQ.png


Multiple Pages

Lists in the Medusa admin can span across multiple pages if the number of items in that list are more than 15.

In that case, you can navigate between pages by clicking the arrows at the bottom of the list.