Algolia DocSearch for Sphinx

This extension for the Sphinx documentation generator replaces Sphinx’s built-in search with Algolia DocSearch.

Before you begin

Apply for DocSearch. You’ll get an email with your Algolia credentials.

This extension supports Python versions 3.8 and later and Sphinx versions 5 and later.

Install the sphinx-docsearch package:

pip install sphinx-docsearch

Add sphinx-docsearch to your Sphinx configuration:

# conf.py
extensions += ["sphinx_docsearch"]

Add your Algolia credentials to your Sphinx configuration:

# conf.py
docsearch_app_id = "<DOCSEARCH_APP_ID>"
docsearch_api_key = "<DOCSEARCH_SEARCH_API_KEY>"
docsearch_index_name = "<DOCSEARCH_INDEX_NAME>"

To change what the crawler should extract from your pages, see Record Extractor.

You can add custom templates, if your Sphinx HTML theme uses templates not provided by this extension.

You can customize the look of the DocSearch UI by adding your own CSS.