Skip to contents

Build a JSON file encompassing all HTML pages, for use by the search script.


build_search(pkg = ".", override = list())



Path to package.


An optional named list used to temporarily override values in _pkgdown.yml

YAML config

You can exclude some paths from the search index. Below we exclude the changelog from the search index.

  exclude: ['news/index.html']

Debugging and local testing

Locally (as opposed to on GitHub Pages or Netlify for instance), search won't work if you simply use pkgdown preview of the static files. You can use servr::httw("docs") instead.

If search is not working, run pkgdown::pkgdown_sitrep() to eliminate common issues such as the absence of URL in the pkgdown configuration file of your package.