Product listing

Showing a list of products based on a category in grid or list view.


  1. In the theme editor (Customize), open the template selector

  2. Select Collections, then Default collection.

  3. On the left-sidebar, add Product listing.

  4. Make necessary changes > Save.


  • Control the listing's container type and layout.

  • Show the number of products per row and per page.

  • Enable/disable box layout.

  • Show layout the columns switcher.

Sorting and filtering

Enable/disable filtering and sorting by options. You can either choose to display filters by storefront filters or by custom tags.

You can also change the filter position, title, and height.


Enable pagination in 3 ways.

Storefront filters settings

This setting is for storefront filters only. You can enable changing product card variants on filtering and showing results count on filter items.

How to create a visual filter

Filter values can include visual elements such as colors, patterns, or other creative imagery.

For example, a Fabric color filter can display a small color swatch for each filter value.

To create visuals with your filter values, set up custom data for your store with metafields and metaobjects. You also need to meet the requirements.

Product variant filters will link to more relevant variants on search results and collection pages.

Now we will start from scratch by defining the metaobjects:

  1. Go to Settings > Custom data > Find the Metaobject definitions field > Click Add definition.

  1. In the Add metaobject definition page, give this metaobject a Name (Color) and 3 Fields:

  • Single line text - For the color name (Name).

  • Color - For the hex code of the actual color (Hexcode).

  • File - For the image of this color (Image).

A metaobject definition for a color swatch should have both a color and an image field.

You don't need to provide a value for both, but this will give you the option of using either field in the future.

  1. Click Save.

Next step, we will create the colors list:

  1. In the Shopify admin sidebar, go to the Content > Metaobjects > In the Metaobjects page, select Color.

  1. Click the Add entry button to add a new color. Give the color entry the Name, Color, and Image.

Note: You can add many color entries and assign these colors to the products.

  1. Click Save.

  1. Go to Settings > Custom data > In the Metafield definitions field, select Products > Click Add definition.

  1. We will define this metafield as Name: "Color filter swatch" and Type: "Metaobject". In the Reference field, select the metaobject you want or you've just created (Color).

If your products/ variants have multiple colors you could filter, set your metafield definition to allow a List of entries.

This lets you assign multiple metaobject entries to a single item and each one will display as a filter value on your store.

  1. Click Save.

Then, we will connect the products to colors:

  1. In the Shopify admin sidebar, go to the Products > Select the product you want to connect color metafield.

  2. In the Metafields field, click on the "Color filter swatch" metafield that you've just created above > You will be able to select multiple colors from your list of colors that you defined using metaobjects.

  1. Click Save.

After you assign the metafield to products/ variants, you can set up the filter for your online store:

  1. In the Shopify Search & Discovery app, go to Filters.

  2. Click Add filter or choose an existing filter.

  3. Click the Source field > select a metafield filter with a metaobject reference - "Color filter swatch".

  4. Click Display options.

  5. Set the Label field for filter values by selecting a metafield.

  6. Check Include visual and select a visual style:

    • Choose Swatch for small color swatches or patterns. Set the swatch content by selecting:

      • A color field for the Swatch color.

      • An image field for the Swatch pattern.

  • Choose Image for icons, logos, or other graphics that shouldn't be cropped.

  • Select an image field for the Image.


Themes often display a swatch's image before its color.

For swatch displays, if you activate both Swatch pattern and Swatch color, the color is only displayed when there isn't an available pattern image for the filter value.

  1. Click Save.

Last updated