For the complete documentation index, see llms.txt. This page is also available as Markdown.

Filter products by metafield

If your product data includes custom metafields (material, fit, certification, technical specs, or anything else you've defined in Shopify), you can declare...

What this does

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.

Prerequisites

  • The metafield must already exist and have values set on your products/variants in Shopify.

  • The number of metafields you can use for filtering depends on your plan — see App pricing.

Steps

  1. In the app, go to Settings > Metafields.

  2. Click Add metafield.

  3. Choose Resource (Product or Variant), then enter the metafield's Namespace and Key exactly as defined in Shopify, and choose what it Applies to (e.g. display, filter, sort, search).

  4. Click Sync metafields, then Save in the bar at the top of the page.

Settings > Metafields — declare a metafield
  1. Go to Filters and open (or create) the filter you want to add it to.

  2. Click Add filter option and choose the metafield as the Source — see Configure filter options.

  3. Give it a Label and click Save.

Once added, manage which of its values show and their order the same way as any other filter option — see Manage filter option values.

Tips

  • Metafields with a list/array type (e.g. multiple certifications on one product) work well as multi-select filter options.

  • After adding new metafield values to products, run Sync Product Data if the new values don't show up right away.

Last updated

Was this helpful?