> For the complete documentation index, see [llms.txt](https://docs.globo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globo.io/filter/filter-sidebar/filter-products-by-metafield.md).

# Filter products by Metafield

✨You can add a filter option based on **Product Metafields** or **Variant Metafields** using the Smart Product Filter & Search app. This is useful for custom attributes like material, style, or any extra data that doesn’t come by default in Shopify.

***

### ✅ Before You Start

Make sure your metafields are already created and contain values in your Shopify admin, as well as being enabled in the app's metafield section (click [here](https://docs.globo.io/filter/~/changes/69/product-variant-metafields/enable-product-metafields) for step-by-step instructions).

* Only **Product** and **Variant** metafields are supported.
* You can’t use metafields from collections, orders, customers, etc.

***

### 🛠 How to Add a Metafield Filter

1. Open the app and go to **Filter** > **Manage Filter**.
2. Click the **Edit icon** on the filter group you want to change.
3. Scroll to **Filter Options** and click **Add Option**.
4. In the **Label** field, enter the name for your filter (e.g., “Material”).
5. Under **Filter Type**, choose either depending on your metafield data:
   * **Product Metafield**
   * **Variant Metafield**
6. Set your **Display Style** (e.g., List, Dropdown, Color Swatch).
7. Click **Add** to save the filter.

<figure><img src="/files/pIOY6QDkDeo2Z7vBGKM4" alt=""><figcaption></figcaption></figure>

***

### 📝 Tips

* Use **Product Metafield** for general product attributes.
* Use **Variant Metafield** if the value changes by variant (e.g., different colors have different textures).
* You can customize how the filter looks with display settings.

***

### 💬 Need Help?

If you have any questions or run into issues, feel free to contact our support team at **<contact@globosoftware.net>**. We're happy to help!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.globo.io/filter/filter-sidebar/filter-products-by-metafield.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.