Facets Configuration

or send an email to support@doofinder.com

In this article

Learn how to configure facets for your search engine from your Doofinder Control Panel.

You can use facets in your search engines to filter results by some fields. Once configured, the facets will appear in your Doofinder layer automatically aside. If you use our API directly you will be able to add filters to your queries (facets and filters are the same thing).

Enter the Doofinder Control Panel with your user and password and navigate to Configuration > Facets. Notice that you need to have any valid data indexed prior to configure your facets. If not, then navigate to Configuration > Product Feed and parse your data (if you need help creating a data feed read this article).

The Facets Configuration Screen

This screen is divided in the same number of sections as the number of datatypes are defined for your search engine. Usually there's only one section: product.

Each datatype section is also divided in two columns. On the left column you will see the available fields that we obtained from your data feed; some of your fields may have been modified for specific purposes and some other may have been removed from the list because they're well known fields that are not intended for filtering. On the right column will appear the facets currently enabled for your search engine and datatype.

By default only the most used facets are displayed but you can browse all your fields by clicking the View All button.

Types of Facets

There are two types: Terms, that are displayed in the Doofinder Layer as list of terms, and Ranges that are displayed as numeric range sliders. The former has an icon representing a list next to the field name and the latter is represented by a small range selector.

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 huge list of references to filter. But brands, colors, a small set of sizes, genre and that kind of stuff are good candidates.

What are those categories and best_price fields? They are not in my data feed...

Well, when we process your data feeds we transform the product type field (or the google product category one) and make some optimizations to manage it as categories so we need to create that field for you.

The same happens with the best price field. In the data feed you can send us a regular price and a sale price but when you filter results you usually want to filter by the current price and it can be the regular price or the sale price. We need the price in a single field to make the filtering so we created the best_price field.

Once you selected some fields you can edit the label of the filter that will be used in the Doofinder layer. You can also sort the facets. Just click, drag and drop. Then use the Save button to make the changes permanent.

When will the facets appear in the Doofinder Layer?

Layer options served from Doofinder are not intended to be constantly changing and they're cached to improve performance. Depending on your users' browser it may take up to 1 hour to be up to date in their computers. But don't panic, for the vast majority of your users it will have no consequences.

If you're developing some changes that you want to test immediatelly, 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 pane is open.

Of course, you can send us an email to support@doofinder.com if you have any problem and need help.

Enjoy!