Refinement List Widget

A widget allows the user to filter the dataset based on facets.

Check out the demo


The refinementList widget is one of the most common widget you can find in a search UI. With this widget, the user can filter the dataset based on facets.

The widget only displays the most relevant facet values for the current search context. The sort option only affects the facets that are returned by the engine, not which facets are returned.

This widget also implements search for facet values, which is a mini search inside the values of the facets. This makes it easy to deal with uncommon facet values.

This component is part of the InstantSearch open source UI library that lets you quickly build a search interface in your frontend application.

InstantSearch’s goal is to help you implement awesome search experiences as smoothly as possible by providing a complete search ecosystem. InstantSearch tackles an important part of this vast goal by providing frontend widgets that you can assemble into unique search interfaces.


Was this useful?


Built and supported by Algolia




The best Search and Discovery Platform for your business.

Recommended content

Frontend Tools
Widgets & Plugins

Refinement List Mobile Component

Components that perform refinements on a facet.

  • Kotlin
  • Swift