Skip to main content
Depending on the query or category, which facets to display in the UI and how to organize values can vary significantly. For example, for an ecommerce platform selling both clothes and tech products, in the “clothing” category you might want to display the facets “brand”, “size”, and “color”, while for TVs, you might want to show “brand”, “screen type”, and “screen size”. Algolia lets you control which facets to display and how to order their values for a given query or category.
This feature requires a specific UI implementation that relies on the latest version of InstantSearch, or with some custom logic built-in.

​
Merchandise facets in the Visual Editor

Consider the earlier example, where an ecommerce platform sells clothes and tech products. First, you need to set a default facet display so that if a user lands on anything but tech products, they see the facets “brand”, “size”, and “color”. With the default order set, you need to set a rule to override this default order for the tech products category.
  1. Select Rules in the Algolia dashboard.
  2. Select Create your first rule or New rule and select Visual Editor.
  3. To set the condition, check whether you have category pages configured on your Visual Editor. You would follow separate steps, depending on whether it’s configured or not: If category pages are configured on your Visual Editor:
    1. Click Choose category page.
    2. Select “Tech Products”.
    3. Click Apply.
    If category pages aren’t configured:
    1. Click Set query condition.
    2. Toggle on Filters and toggle off Query,
    3. In the Filter name field, enter Brand. In the Filter value field, enter Tech Products,
    4. Click Apply.
  4. In the Consequences section:
    1. Click the Order facets button.
    2. Import the default order defined for your facet display by selecting Import default order.
    3. Click the trash icon next to the facets “size” and “color” so they’re not displayed anymore in this category.
    4. Click the Add facets button and select “screen type” and “screen size” to add them to the list of facets to display.
    5. Use the = icon to reorder the facets by dragging and dropping them. The order in the UI is the same as the order in the dashboard.
  5. Review and publish your changes.

​
Merchandise facet values in the Visual Editor

Selecting which facets to display and in which order is one aspect of facet merchandising. The other aspect is about facets values. By default, the values within each facet are ordered by count: the values with the highest number of matching results appear at the top. You can tweak this order in several ways:
  • You can pin some values to the top of the list. For example, you might have a partnership with a specific brand that you always want to display at the top of the list.
  • The non-pinned values can then be ordered by count, alphabetically, or hidden so that only pinned values are displayed.
Going back to the earlier example, now on top of displaying the facets “brand”, “screen type”, and “screen size” in the category “tech products”, you also want:
  • To pin the brand “Sony” at the top of the list of brands
  • Have the other brands ordered alphabetically
  • Have the “screen type” values ordered by count
  • Only display the three most common values for “screen size”: 32, 55, and 65 inches.
  1. Select Rules in the Algolia dashboard.
  2. Under the Rules header, select the index to which you’re adding a rule.
  3. Identify the rule created in the earlier example, click the three dots (ellipsis), and select the option “Edit this Rule”.
  4. In the strategy section, click the pen icon to edit the facet display strategy.
  5. To set the strategy for the “brand” facet:
    1. Click the pen icon to edit the “brand” facet.
    2. Click “pin facet value” and select the brand “Sony” to pin it to the top of the list.
    3. To order subsequent values, in the drop-down menu, click “alphabetically”.
  6. For the “screen type” facet, the order should already be by count, so you should have nothing to change here.
  7. To set the strategy for the “screen size” facet:
    1. Click the pen icon to edit the “screen size” facet.
    2. Click “pin facet value” and select the values 32in, 55in, 65in to pin them at the top of the list.
    3. Use the = icon to drag the values into the correct order.
    4. To order subsequent values, in the drop-down menu, select “do not display” to ensure that only the three selected values are displayed.
  8. Review and publish your changes.

​
Merchandise facets and their values in the Manual Editor

Merchandising facets and their values is also possible using the Manual Editor but requires an understanding of the setting renderingContent.
  1. Select Rules in the Algolia dashboard.
  2. Under the Rules header, select the index you are adding a Rule to.
  3. Select Create your first rule or New rule. In the drop-down menu, select the Manual Editor option.
  4. In the Condition(s) section, toggle Filters on. Select “screen type” in the attribute name field, and “tech products” in the attribute value field.
  5. Still in the Condition(s) section, toggle Query off.
  6. In the Consequence(s) section:
    1. Click the Add consequence button and select Add query parameter.
    2. In the input field, enter the JSON to customize the renderingContent parameter. For example, to match the same example as described for the Visual Editor, the JSON would look like this:
JSON
{
  "renderingContent": {
    "facetOrdering": {
      "facets": {
        "order": ["brand", "screen type", "screen size"]
      },
      "values": {
        "brand": {
          "order": ["Sony"],
          "sortRemainingBy": "alpha"
        },
        "screen type": {
          "sortRemainingBy": "count"
        },
        "screen size": {
          "order": ["32in", "55in", "65in"],
          "sortRemainingBy": "hidden"
        }
      }
    }
  }
}
  1. Save your changes.
⌘I