# What changed in @docsearch/js

> 20 changes in @docsearch/js 4 to 5 from its official release notes, upgrade guides and advisories: 2 breaking, 12 new APIs and options. Each one cited. Sources checked 2026-10-26. HTML: https://unstale.sh/npm/@docsearch/js/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @docsearch/js 5

### Breaking changes

- The Ask AI transport layer has been removed. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)
- Ask AI related props are now nested under the single root askai option. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)

### New APIs and options

- Agent Studio integration adds core tools and dynamic tool calls. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)
- The integration supports the Algolia MCP search tool, including aggregated MCP search tool calls. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)
- Conversation memory support is available for Ask AI. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)
- Agent Studio can select indexes dynamically. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)
- Search supports facets displayed with filter chips. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)
- Feedback integration supports feedback notes and tags. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)
- The new footerAction prop renders a custom action in the modal footer before the Algolia logo and supports html helper, JSX, or function-based template patterns. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)
- Search results can display hit breadcrumbs. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)
- MCP plugins are supported. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)
- Prompt suggestions are available in keyword search and as follow-up suggestions. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)
- Search results can display badges. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)

### Performance

- Bundled DocSearch packages are now development dependencies, reducing the install footprint for consumers. (5.0.2) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.2)
- JS bundles are split to support search-only usage and JS-based hybrid mode. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)

### Behavior and default changes

- The search UI is refreshed with an improved dark theme, sources panel, and accessibility. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)

### Tooling

- A new CLI package provides MCP setup and search. (5.0.0) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.0.0)

### Fixes and other changes

- Fixed a crash when importing DocSearch bundles on Safari 14 caused by an incorrectly optimized lookbehind feature detection. (5.1.1) — [release notes](https://github.com/algolia/docsearch/releases/tag/%40docsearch/js%405.1.1)

## @docsearch/js 4

### New APIs and options

- Adds support for searching across multiple indexes. (4.0.0) — [release notes](https://github.com/algolia/docsearch/blob/HEAD/CHANGELOG.md)

### Behavior and default changes

- Ask AI supports AI SDK v5. (4.0.0) — [release notes](https://github.com/algolia/docsearch/blob/HEAD/CHANGELOG.md)