Installation

Note

This extension is developed to be used only on Read the Docs. If you are building your documentation locally, this extension will degrade gracefully. However, if you have a local instance of Read the Docs running, you can make this extension work by building your documentation with it by following the instructions on the development page.

Install the package

pip install readthedocs-sphinx-search
pip install git+https://github.com/readthedocs/readthedocs-sphinx-search@master

Then, enable this extension by adding it to your conf.py.

# conf.py
extensions = [
    # ... other extensions
    'sphinx_search.extension',
]

After installing the package and adding it to your conf.py file, build your documentation again on Read the Docs and you’ll see the search UI in your documentation.