Skip to content

Attribute configuration

Richard Bayet edited this page Jan 30, 2020 · 10 revisions

Attributes configuration

Search Configuration

Each product attribute can be configured to be used in Search and/or Catalog Layered Navigation.

On the attribute edition page in Magento back-office (Stores > Attributes > Product), following parameters can be modified on the Storefront Properties tab :

Attribute configuration

Parameter Default value Description
Use in Search No If the attribute is used for product search. Eg : Setting it to "Yes" for the "Color" attribute allows to obtain result when searching on "blue hoodie" or "red jacket".
Search Weight 1 The weight of this attribute in search.
Used in spellcheck No When set to "Yes", the engine will compute spellchecking (see Spellchecking) on this attribute values.
Display in autocomplete No When set to "Yes", values of this attributes will be shown in autocomplete results.
Visible in Advanced Search No If this attribute can be used on the Advanced Search page.
Use in Layered Navigation No Set this to "Filterable (with results)" to display this attribute as a search filter (facet) on the Catalog Navigation pages.
Use in Search Results Layered Navigation No Set this to "Yes" to display this attribute as a search filter (facet) on the Search Result pages.

You can refer to the following section to enhance the faceting configuration.

Faceting configuration

Each product attribute can also be configured when it is used as a facet in the search results and/or category view page.

On the attribute edition page in Magento back-office, following parameters can be modified :

Facet configuration

Parameter Default value Description
Facet coverage rate 90 The minimum coverage rates of results by this attribute.
Example, if set to 90% on the "Brand" attribute, the facet will be displayed only if 90% of the products in the search results or category have a brand.
Facet max. size 10 The maximum number of values that will be displayed for this facet. If the attribute features more values than this limit, a Show more button will be displayed after the values listing and an autocomplete search box will appear automatically above the values listing.
Facet sort order Result count This is how the facet values will be ordered.

  • Result count : Will order values according to their number of results (descending).
  • Admin sort : Values will be displayed as ordered in attribute's options values in Magento back-office.
  • Name : Values will be displayed alphabetically (ascending).
  • Relevance : Values are displayed by relevance.

Faceting configuration by category

ElasticSuite allows you to customize layered navigation configuration of each category.

How to.

On a category edit page, you can access the Display Settings tab.

Under this tab you will see a new entry called Layered Navigation Filters

Please note this entry only appear on existing categories. You will not see the Layered Navigation Filters entry when creating a category.

Layered Navigation Configuration

This grid will allow you to customize filterable attributes for the current category.

Manage filter position

The first main thing is that you are able to change the position of each filter. By default, each filter is using the global position value which has been defined inside Stores > Attributes > Product page.

Here you will be able to reorganize them so they will fit better with this category.

This is useful if your store is selling a large variety of products : "Author" and "Theme" attributes will be set on top for books related categories, but they have no sense on DVD related categories.

To reorder the filters just click on the Pinned switch on the right column : the filter will be moved on top of the list.

You will then be able to reorganize pinned items via drag-and-drop to perfectly fit the ordering that suits you best for this category.

When you unpin an item, it will take back its original position.

Pin / Upin filter

Manage filter display

The other point here is that you will be able to configure how the filter will be displayed for this category.

The default value of each fields are the one that have been set for this attribute in previously

Parameter Default value Description
Display Mode Auto This is how the filter will be displayed.

  • Auto : The filter will be displayed according to its coverage rate. This is the standard behavior and will automatically hide filter if it's not really relevant (not covering enough products) for the category.
  • Always displayed : The filter will be always displayed and not take the coverage rate into account.
  • Always hidden : This filter will never be displayed in this category, even if it could have been relevant.
Facet coverage rate Attribute global value You can edit this one in combination with Display Mode : auto to widen or reduce the minimum coverage rate for an attribute on the current category.
Facet max. size Attribute global value As explained previously.
Facet sort order Attribute global value As explained previously.

If you want to reset the value of a field to it's default value, just check the Use Default checkbox and save your category.

Using Sliders for Custom attributes

ElasticSuite allows you to display custom attributes of yours with Sliders (like the Price).

There are some prerequisites to respect for this point to work :

  • your attribute values must be exclusively digits
  • you must specify that your attribute is using "Decimal Number" as imput validation, or "price" as input type.

Let's see a quick how-to for a new attribute.

This attribute will be Temperature and we plan to display a slider of values in Celsius degrees.

Create the attribute

Let's go to Stores > Product > Attributes and create a new One.

I call it "Temperature", set its code to "temperature" and the input as a text field.

Temperature Attribute Init

Then I set the "Input validation" to "Decimal Number"

Decimal Number

Next step is to configure the attribute for being filterable in layered navigation and/or in search. See the steps describe above to perform this.

Once you are done, you can click on Save and Continue Edit and go back to the StoreFront properties.

You will then see a new fieldset named Slider Display Configuration

In this fieldset you can configure the display of your newly created attribute :

Slider configuration

Parameter Default value Description
Display pattern In this field you should enter the pattern for your Slider. "%s" represents the value. So if you type "%s °C" you will obtain something like : "20 °C".
Display precision 0 The number of digits to show for precision when filtering. Let this field to 0 to have a slider displaying integer values.

Once you are done, you can now populate this attribute values for your products. Then all you will have to do is to process a full reindex.

The slider should now be displayed in the Front-Office :

Slider front

Clone this wiki locally