Need help?

Can't find what you are looking for? Try with one of these:

Facets Configuration

The ‘Facets’ functionality is used to filter results based on the fields of your data feed. Once configured, they will appear in your Doofinder layer automatically. In case you use our API directly, you will be able to add filters to your queries.

📌 Note: Facets are used to filter results. It would be best if you had your data feed indexed before configuring your facets.

Types of Facets

There are two types of facets:

Terms: displayed in the Doofinder layer as a list of terms/categories. This has an icon representing a list next to the field.

Ranges: displayed as numeric range sliders. Represented by a small range selector. Note that only numeric fields will be displayed as range sliders.

Not all fields are good for filtering. For example, a field that stores product references is not good because it’s very difficult to find a set of items sharing the same reference, and you would get a long list of filter references. However, brands, colours, sizes and genres are good options to filter.

How to Configure the Facets

To configure the facets feature, log in to your Admin account and go to Search Engines > Settings > Facets.

On the left column, you will find the available fields that Doofinder obtained from your data feed. For example: categories, brand and best_price.

The right column is for naming the facet and will be displayed in your search engine.

To add a new facet, click on the FIELD dropdown menu and select the field you want to apply as a filter. For the purposes of this exercise, we will choose ‘brand’.

📌 Note: that you can only add up to 10 fields in the facets. This will help maintain the speed of the search function.

Now, type a ‘Label‘ to name your facet, for example: ‘Best Brands’. If you want to display the filter in the Doofinder layer, click on the ‘visible’ checkbox. You can arrange the number of TERMS you want to display by changing the default number ’20’. Once you are done, click on ‘+Add’ and hit the ‘Save’ button.

Categories and best_price Fields

When Doofinder processes your data feed, it transforms the product type field (or the Google product category) and optimises it as categories. Hence, Doofinder needs to create that field for you.

The same happens with the best price field. In the data feed, you can submit a regular price and a sale price, but when you filter results, you usually want to filter by the final price, and it can be the regular price or the sale price. Doofinder will require the price in a single field to make the filtering, hence why the best_price field exists.

Once you’ve selected some fields, you can edit the filter label that will be used in the Doofinder layer. You can also sort the facets. Just click, drag and drop. Then hit the Save button.

When will the facets appear in the Doofinder Layer?

Depending on your users’ browser, it may take up to 1 hour to be up-to-date on their computers. Layer options served from Doofinder are not intended to be constantly changing, and they’re cached to improve performance.

If you’re developing some changes that you want to test immediately, you can disable your browser’s cache. For instance, Chrome lets you do this from the Network tab in the Dev Tools by enabling Disable Cache. That will take effect only while the Dev Tools panel is open.

Also, facets are sorted by the number of products with the highest number at the top. If you prefer to order them differently, say by size, colour and so on, you can follow the directions given here. Note that you will require some programming experience to make the changes.