# What changed in @orama/orama

> 12 changes in @orama/orama 3 from its official release notes, upgrade guides and advisories: 1 breaking, 8 new APIs and options. Each one cited. Sources checked 2026-10-27. HTML: https://unstale.sh/npm/@orama/orama/

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

## @orama/orama 3

### Breaking changes

- Orama methods are now synchronous, changing how developers call and await them. (3.0.0) — [release notes](https://github.com/oramasearch/orama/releases/tag/v3.0.0)

### New APIs and options

- Answer session APIs were added to Orama OSS. (3.0.0) — [release notes](https://github.com/oramasearch/orama/releases/tag/v3.0.0)
- Customization of the Docusaurus search button was added. (3.0.0) — [release notes](https://github.com/oramasearch/orama/releases/tag/v3.0.0)
- A plugin was added to generate embeddings locally at runtime. (3.0.0) — [release notes](https://github.com/oramasearch/orama/releases/tag/v3.0.0)
- The @orama/plugin-pt15 package was added. (3.0.0) — [release notes](https://github.com/oramasearch/orama/releases/tag/v3.0.0)
- The plugin-qps package was added. (3.0.0) — [release notes](https://github.com/oramasearch/orama/releases/tag/v3.0.0)
- RAG APIs were added to Orama OSS. (3.0.0) — [release notes](https://github.com/oramasearch/orama/releases/tag/v3.0.0)
- The plugin can generate embeddings when documents are inserted. (3.0.0) — [release notes](https://github.com/oramasearch/orama/releases/tag/v3.0.0)
- Orama switch methods were improved, including support for answer sessions. (3.0.0) — [release notes](https://github.com/oramasearch/orama/releases/tag/v3.0.0)

### Behavior and default changes

- Tokenization caching is avoided during insertion. (3.0.0) — [release notes](https://github.com/oramasearch/orama/releases/tag/v3.0.0)
- Search with filters was improved. (3.0.0) — [release notes](https://github.com/oramasearch/orama/releases/tag/v3.0.0)

### Fixes and other changes

- A fix was made to edit distance calculation. (3.0.0) — [release notes](https://github.com/oramasearch/orama/releases/tag/v3.0.0)