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

Search by product metafields

Overview

Let shoppers find products by the values stored in your product metafields, such as material, brand, or fit. You choose which metafields are searchable on the Metafield page, and each searchable text metafield gets its own row in Search Settings, where you can fine-tune how it matches and how much it counts in search ranking.

What's Inside

Setting / Option
Description

Apply to: Search

Makes a metafield searchable. Set on the Metafield page via the pencil (Edit) icon. A metafield can be applied to Filter, Search, or both.

Supported metafield types

Only Single line text, List of single line text, and Multi-line text metafields can be searched. Other types (Decimal, Color, File, etc.) can still be used for filtering.

Metafield rows in Search Settings

Each searchable text metafield appears as its own row at the bottom of the search fields table, marked with a Metafield tag.

Search type

How a typed keyword must match the metafield value: Whole words (default), Word beginnings, or Any part of a word. Requires Partial Search.

Weight

How much a match on this metafield counts toward a product's search score. Default is 1. Requires Partial Search.

Synced Search checkbox

The checkbox on a metafield row in Search Settings and the Search option under Apply to are the same setting. Changing one updates the other.

Selected metafields limit

You can select up to 10 metafields in the app. If your store needs more, contact our support team via the in-app chat to request extra metafields for free.

Location & Setup

Part 1: Make a metafield searchable

1

Open the Metafield page

In Shopify admin, go to Apps > Findter Custom Filter & Search > Metafield.

2

Select a metafield

Click the Search for metafield box and tick the metafield you want to use. The metafield type is shown on the right of the list. Newly added metafields are applied to Filter by default.

3

Click the pencil icon on the metafield's row. In the Apply to dialog, tick Search (you can keep Filter ticked as well), then click Save in the dialog.

If a metafield is not a text type (for example Decimal, Color, or File), the Search checkbox is greyed out. Hover over the info icon to see: "Search is only available for text fields."

4

Save on the Metafield page

Click Save on the Metafield page. A yellow Collecting data banner appears while the app collects your metafield data.

5

Wait for indexing to finish

Wait until the green Data indexing is completed banner appears before testing search on your storefront. Stores with many products take longer to index.

Part 2: Fine-tune it in Search Settings (optional)

1

Find your metafield rows

Go to Search > Search Settings. Your searchable metafields are listed at the bottom of the search fields table with a Metafield tag, in the same order as on the Metafield page. The checkbox on each row is the same as the Search option under Apply to.

2

Set Search type and Weight

If Partial Search is enabled, click the arrow on a metafield row to expand it, then set its Search type and Weight. Hover over the info icon to see what each search type does (see Search types below).

3

Save your changes

Click Save on the Unsaved changes bar at the top of the page, or Discard to drop your changes.

Search types

Search type
How it matches

Whole words (default)

Matches complete words only.

Word beginnings

Matches the start of a word. Typing "jack" returns "jacket".

Any part of a word

Matches any part of a word.

Highlights

  • Search by any product text metafield, such as material, brand, care instructions, or fit.

  • Use the same metafield for both filtering and search, or for just one of them.

  • Each metafield has its own row in Search Settings, so you can tune its Search type and Weight independently from other fields.

  • The Search checkbox stays in sync between the Metafield page and Search Settings, so you can manage it from either place.

  • If you delete a metafield and add it back later, the app remembers its last Search setting, Search type, and Weight.

  • A save prompt protects you from losing changes: leaving the page with unsaved changes shows "You have unsaved changes. Leave without saving?"

Common Use Cases

🤔 How to let shoppers search by product material?

STEP 1: Go to Apps > Findter Custom Filter & Search > Metafield.

STEP 2: Click Search for metafield and tick your Material metafield (it must be a text type).

STEP 3: Click the pencil icon on the Material row, tick Search, and click Save in the dialog.

STEP 4: Click Save on the Metafield page and wait for the green Data indexing is completed banner.

STEP 5: On your storefront, search for a material such as "linen" to check that matching products appear.

🤔 How to match partial keywords in a metafield (for example "jack" finding "jacket")?

STEP 1: Make sure Partial Search is enabled on the Advanced Features page. If it is not, click to enable it and our support team will activate it for your store.

STEP 2: Go to Search > Search Settings and find the metafield row at the bottom of the table.

STEP 3: Click the arrow to expand the row and set Search type to Word beginnings (matches the start of a word) or Any part of a word (matches anywhere in a word).

STEP 4: Click Save on the Unsaved changes bar.

Any part of a word returns broader, less precise results. Use Word beginnings if you only want to match the start of words.

🤔 How to give a metafield more influence on search results?

STEP 1: Make sure Partial Search is enabled on the Advanced Features page.

STEP 2: Go to Search > Search Settings, expand the metafield row, and increase its Weight (default is 1).

STEP 3: Click Save on the Unsaved changes bar.

Weight is a multiplier, not a fixed ranking order. A product's score adds up matches across all searchable fields, so a higher metafield weight increases its influence but does not guarantee that product will rank first. For example, a product whose variant matches the keyword can still rank above a product whose metafield matches with a higher weight.

🤔 How to turn search on or off for a metafield from Search Settings?

STEP 1: Go to Search > Search Settings.

STEP 2: Tick (or untick) the checkbox on the metafield row.

STEP 3: Click Save on the Unsaved changes bar.

STEP 4: Open the Metafield page. The Apply to column for that metafield now shows (or no longer shows) Search.

🤔 How to fix a metafield search that returns no results?

Check the following in order:

STEP 1: On the Metafield page, confirm the metafield has Search under Apply to, and that you clicked Save on the page (not only in the dialog).

STEP 2: Confirm the green Data indexing is completed banner has appeared. Stores with many products take longer to index.

STEP 3: In Search > Search Settings, confirm the metafield row is ticked. If a metafield is applied to Filter only, it is not searchable and its row is unticked.

STEP 4: Confirm the metafield is a text type and the products you expect actually have a value in that metafield. Products without a value will not match.

STEP 5: If the row's Search type is Whole words, make sure you typed the full word. Try Word beginnings or Any part of a word for partial matches.

STEP 6: Still not working? Contact our support team with your store URL, the metafield (namespace.key), the keywords you tried, and a screenshot of your Search Settings.

Good to know

  • If you delete a metafield and add it again, the app restores its last Search setting, Search type, and Weight.

  • If you leave the Metafield or Search Settings page with unsaved changes, a dialog asks "You have unsaved changes. Leave without saving?" Choose Save to save and continue, or Discard to drop your changes and continue.

Support Information

Need help? Contact our support team via the in-app chat or at Findter Support.

Last updated