Use Shopify Product Metafield Data for Filters in Theme

Sun, 20 Jul 2025 00:00:00 +0000

In a recent Shopify project, I set up custom Product Metafields to store additional product information, and then exposed them in the theme so that customers could filter results by those metafield values.

It wasn’t as straight-forward as I expected, so I’m writting up this tutorial to show the steps to achieve this.

Set Up Product Metafields

Create your Product Metafield in whatever configuration you need to store your data. Then, check off the “Use as a filter” option at the bottom of the Metafield definition form:

Once you have your Metafield set up, go into your products and update them to add values into this field.

The Shopify Product Bulk Update feature is really handy for this, just remember to expose the metafield by clicking the “Columns” button at the top right so you can see the field!

Install Search & Discovery App

If you don’t already have it installed in your shop, install the free Shopify Search & Discovery App. Then open the App and click on Filters:

Click “Add filter” at the top to open the form to create a new filter, then click “Select source”, which will open up a new modal:

Each row in this modal is a piece of structured data in your store that can be used for filtering. Find your Metafield in this list and select it.

For this example, I am using the “Country of Origin” field, which is a single-line text field with a pre-defined list of 3 options to choose from. Once you select the Metafield you want to use, the form will update showing the existing values of that field:

Once you click Save, this new filter will be displayed in your list of filters:

That’s it, You Now Have a Metafield Filter!

After saving your filter, when you go to your website and view a collection whose products have values in this new Metafield, you’ll now see a new filter in the filters area:

The above screenshot is using the Horizon theme without any customization.

And here’s a screenshot of the same data displayed in the Dawn theme without any customizations.

Add structured data to Shopify products with Product Metafields

Wed, 25 Jun 2025 00:00:00 +0000

Shopify’s native product fields are probably sufficient for 95% of businesses selling simple products, but for some businesses, the product catalog could benefit from having more structured data defined at the product level.

That’s why Shopify introduced Product Metafields in 2021, and has been iterating on the feature ever since.

From Shopify’s documentation, here are some examples of the type of product data that can be stored in metafields:

part numbers
color swatches
launch dates
related products
blog post summaries
files for download
lists of ingredient

As I write this in June of 2025, there are 26 different metafield content types available.

For most shops, the most common data types you’ll use are probably text and color.

Example Product Metafield Setup

Let’s say that a store selling clothes wants to display these additional details on each product:

Country of Origin
Machine Washable

Product Metafield with Drop-down Options

For the Country of Origin field, we’re obviously storing text, but if you were to allow users to type into a free-form text field, you’ll end up with messy duplicates like “USA” vs “United States” versus “US”. So instead of a plain text field, you’ll want to set up a drop-down field with a predefined set of options for to user to choose from.

To open the Metafield definitions screen, click on Settings>Metafields and metaobjects>Products, which will take you to a list of all existing Product Metafields. If you haven’t yet made any, it’ll look like this:

Click “Add definition” and enter the text you want displayed in the Product admin for this field, in this case, “Country of Origin”. You can add text in the “Description” field if you’d like but it’s not required.

Then click “Select type” to open the field data type options drop down:

In this case, we’ll choose “Single Line Text”, since the values will always be short (ie country names). If we needed to store longer text, we’d choose “Multi-line text”, or to store numbers, choose Integer or Decimal, etc.

Once you’ve clicked “Single Line Text”, the form will update with that selection and two new options, “One value” or “List of values”:

The wording on these two options maybe could be clearer, but essentially these two options mean “allow the user to enter one piece of text” vs “allow the user to enter a list of text”. In other words, do you want the field to store text like “USA” for a Country of Origin field, or text like “Milk, Sugar, Butter” for a field that stores a list of ingredients.

Once you choose “One value”, some more options appear below:

All of these additional options are optional, but in our case, we’ll be choosing “Limit to preset choices” in order to create our drop down menu of countries for the uer to choose from. Once you’ve checked that checkbox, a field appears to allow you to enter the options:

Type all the options you want to have in this field, click save, and you’re done!

In the Admin, the product will now display this new field in the Product metafields section, and clicking into the field will display the drop down with the options you set up:

Product Metafield with True/False Values

In the case of the “Machine Washable” field, the only valid options are “Yes” and “No”, which in programmer-speak is a boolean value – the only acceptable options are True (“Yes”) and False (“No”).

Shopify shows this data type as “True or false” in the “Select type” drop down, because they are trying to be friendly to non-developers, but if you type “boolean” into the search, it understands what you are looking for:

Since this is a much simpler type of field with only two valid options, there are no additional configuration options after choosing it from the drop down, you can just click Save after choosing it.

Now on the Product admin screen, the new Metafield is displayed and when you click into it, the options True and False are displayed as radio buttons, allowing only one selection to be made:

Ivete Tecedor