⚡ Lightning-fast search for React, by Algolia

Downloads in past


3,1511116.42.03 days agoa year agoMinified + gzip package size for react-instantsearch-hooks-web in KB


Table of Contents generated with DocToc
- Why
- Installation - Getting started - Documentation - Playground - Contributing - License
React InstantSearch Hooks Web is an open-source React library that lets you create an instant search result experience using Algoliaalgolia-website’s search API. It is part of the InstantSearch family:
React InstantSearch | InstantSearch.jsinstantsearch.js-github | Angular InstantSearchinstantsearch-angular-github | Vue InstantSearchinstantsearch-vue-github | InstantSearch Androidinstantsearch-android-github | InstantSearch iOSinstantsearch-ios-github


You should be using React InstantSearch Hooks Web if you want to:
  • Design search experiences with best practices
  • Customize your components at will
  • Follow React principles

Note: If you are working with React Native, or otherwise do not use the DOM, check out react-instantsearch-hooks instead.


React InstantSearch is available on the npm registry. It relies on algoliasearch to communicate with Algolia APIs.
yarn add algoliasearch react-instantsearch-hooks-web
# or
npm install algoliasearch react-instantsearch-hooks-web

Getting started

Using React InstantSearch Hooks Web is as simple as adding these components to your app:
import React from 'react';
import ReactDOM from 'react-dom';
import algoliasearch from 'algoliasearch/lite';
import { InstantSearch, SearchBox, Hits } from 'react-instantsearch-hooks-web';

const searchClient = algoliasearch(

const App = () => (
    <SearchBox />
    <Hits />

<img alt="Edit on CodeSandbox" src="">

To learn more about the library, follow the getting started guidedoc-getting-started.


The documentation is available on


You can get to know React InstantSearch on this playgrounddoc-playground.
Start by adding componentsdoc-getting-started and tweaking the display. Once you get more familiar with the library, you can learn more advanced concepts in our guidesdoc-guides.


We welcome all contributors, from casual to regular 💙

To start contributing to code, you need to:
  1. Fork the project
  2. Clone the repository
  3. Install the dependencies: yarn

Please read our contribution process to learn more.


React InstantSearch Hooks is MIT licensed.