Skip to content
Farin Theme Guide
GuidesStore and Products

Search

While you type, Farin search shows products under the box and understands Persian writing: “ی” and “ي”, “ک” and “ك”, Persian and English digits, and the half-space are all the same to it. Before typing, it can also show a banner, suggested products, and popular phrases.

Where is it? Farin → Site content → Store and Products → Search

Preview

Preview of the open search box with a tablet banner, four suggested products, and five popular phrases
The open box before typing: the banner on top, “Our suggestions” and “Popular searches” below it.

The preview shows the box as the buyer sees it after tapping it and before typing. It refreshes with every save. On the site, as a few letters are typed, the results replace these.

Search box

The search settings box with the farin_search shortcode, placeholder text, number of results, and two switches
Put the shortcode above the box anywhere, and this same search box appears there.

Search box with a shortcode [farin_search] It sits wherever you like: a header you build, the home page, or any page. The “Search” section in Header and the bottom bar’s search Mobile both show this same search. Pressing Enter opens the results page for this search, whose look is set by the Store .

OptionWhat it doesDefault
Placeholder text inside the boxThe faint text inside the empty box, up to 80 characters.Search products…
Number of results while typingHow many products appear under the box, from 3 to 20. The rest are seen with “All results” on the results page.8
Product image beside the resultA small product image beside its name.On
Price beside the resultThe product price beside its name.On

Color

The search color box with eight ready-made colors and the main search color
Tapping a ready-made color makes it the “Main search color”.
OptionWhat it doesDefault
Ready-made color schemesFarin purple, midnight, turquoise, forest, golden, sunset, pomegranate, and gray.Farin Purple
Main search colorThe box edge while typing, the selected result, the suggestion labels, and “All results”. You can type a color code too.#7b2cbf

What to search

The what to search box with the product ID and category name switches and the search index status
The bottom of the box says how many products are ready in the search index; here it is 17 of 17.

The product name is always searched. All the words the buyer types must be found; “Samsung phone” brings up a product that has both words. Results are ordered like this: first a name that is exactly the same, then a name that starts with it, then a name where a word starts with the phrase, and finally the rest. Within each tier, in-stock products come before out-of-stock ones.

OptionWhat it doesDefault
Product ID (SKU)Typing the product ID finds it too; the IDs of variable product variations as well.On
Category nameThe product category name is searched too. For example, “shoes” also finds products in the shoes category, even if the word shoes is not in their name.On
Rebuild the indexRebuilds the search index of all products from scratch.
What is the search index?For each product, Farin keeps a normalized copy of its name, IDs, and category names so search is fast. Each time you save a product, its copy is refreshed automatically. When you change one of the two switches above, the index of all products is rebuilt in the background and you see its message. If the “ready” number stays below the total number of products (for example, after a bulk product import), press “Rebuild the index”.

Only published, visible, password-free products appear in the results. If “Hide out of stock items” is on in WooCommerce settings, out-of-stock products do not appear either.

Before writing

The before typing box with the suggestions heading, four selected products, and the list of popular phrases
Four products are chosen for “Our suggestions”; remove each with the × beside it.

These are shown when the box opens and nothing has been typed yet. Any section left empty is not shown.

OptionWhat it doesDefault
Suggested products headingUp to 60 characters.Our suggestions
Suggested products (up to 6)Type part of a product name and pick it from the list. Only published products are found and shown. The display order is the order of adding.Empty
Popular phrases headingUp to 60 characters.Popular searches
Popular phrasesOne phrase per line, up to 10 phrases. Tapping one shows the buyer that phrase’s search. You write this list yourself; it is not built from buyers’ searches.Empty
The search banner box with a tablet image, headline, subtitle, button text, and a product address
The banner address goes to a product page, and that page’s name is written under it.

The banner sits above the suggestions. With no image, no banner appears.

OptionWhat it doesDefault
Banner imageSuggested size 1080 × 300. Pick it from media with “Choose” and remove it with “Remove”.
Banner headlineUp to 80 characters.Empty
SubtitleUp to 120 characters.Empty
Button textUp to 30 characters.Empty
Banner addressWhere the banner goes; an on-site address such as /shop/ or a full address.Empty

Frequently Asked Questions

A product I know exists is not found in search.

First check that the product is published, has no password, and is visible in the shop list. Then look at the “search index” number; if not all products are ready, press “Rebuild the index”. Remember that all the typed words must be found in the name (or ID and category, if those are on).

The buyer types with an Arabic keyboard “ي” or “ك”; will it be found?

Yes. “ی” and “ي”, “ک” and “ك”, Persian and English digits, and the half-space are treated as the same; “آیفون 15” and “آيفون 15” give the same result.

Where should I put the search box?

In the Farin header, put the “Search” section in the layout of Header . In any page or Elementor template, write the shortcode [farin_search] there.

Farin Theme · 1405