⚠️ Breaking Change
Impact Score: 7/10
Meilisearch v0.22.0 — Release Notes & Engineering Impact
Source available — automated, not human-reviewed
Component: meilisearch · Channel: stable. Automated analysis, not a compatibility certification. How this works.
Analysis updated: 2026-11-01.
Breaking-change evidence from the source
Breaking changes - New syntax for custom ranking rules:
⚡ Executive Summary (TL;DR)
Meilisearch v0.22.0. Source highlight: New syntax for custom ranking rules:
Who Does This Impact? (Role-Based Analysis)
💻 Software Engineers & Devs
Check the source notes against the package and APIs you use before upgrading.
📊 Product & Engineering Leads
Use the documented changes to assess relevance to your product; release frequency alone is not a quality measure.
⚙️ DevOps & Security
Verify the target version, runtime requirements and rollback procedure in the official documentation.
⚠️ Breaking Changes & Deprecations (1)
- Breaking changes - New syntax for custom ranking rules:
✨ New Features & Capabilities (3)
- Sort at query time. For more information, read our dedicated guide
- Make the download script compatible with Windows (requires Cygwin or equivalent)
- Custom ranking rules now work with fields containing strings, not only numbers
🔧 Bug Fixes & Patches (1)
- Fix crashes and RAM consumption issues
📄 View Raw Release Notes (Original Developer Log)
## Breaking changes
- New syntax for custom ranking rules:
```js
# new syntax
"price:asc"
# old syntax (deprecated)
"asc(price)"
```
- New indexer integration
We completely rewrote the indexer in order to:
- Fix crashes and RAM consumption issues
- Increase indexation speed
- Fix indexation bugs
Using the new indexer requires re-indexation of all your documents. This will be done automatically when migrating your data from a previous version. For more information on how to update to the latest version of MeiliSearch, [read our dedicated guide](https://docs.meilisearch.com/create/how_to/updating.html#update-to-the-latest-meilisearch-version).
## New features
- Sort at query time. For more information, read [our dedicated guide](https://docs.meilisearch.com/reference/features/sorting.html)
⚠️ If you import your data via a dump, the `sort` ranking rule must be added manually. Check your ranking rules via the [`GET indexes/:ui/settings/ranking-rules` route](https://docs.meilisearch.com/reference/api/ranking_rules.html#get-ranking-rules). If the `sort` is not listed, you can add it to the 5th position using the [`POST indexes/:uid/settings` route](https://docs.meilisearch.com/reference/api/ranking_rules.html#update-ranking-rules).
- Make the [download script](https://install.meilisearch.com) compatible with Windows (requires Cygwin or equivalent)
- Custom ranking rules now work with fields containing strings, not only numbers
## Misc
- Remove Sentry
- Remove Dependabot: updating dependencies has been integrated into our sprint process
- Improve Docker CIs
- Update README
❤️ Thanks to the @meilisearch/core-team but also to: @singh08prashant, @CaroFG, @shekhirin, and @okyanusoz