Meilisearch v0.21.0stable Released Aug 23, 2021
โš ๏ธ Breaking Change Impact Score: 7/10

Meilisearch v0.21.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 - The index setting `attributesForFaceting` has been renamed to `filterableAttributes`
Read the original context โ†—
Source flags breaking changes โ€” review applicability
๐Ÿ“„ .MD
โšก Executive Summary (TL;DR)

Meilisearch v0.21.0. Source highlight: The index setting `attributesForFaceting` has been renamed to `filterableAttributes`

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 - The index setting `attributesForFaceting` has been renamed to `filterableAttributes`

โœจ New Features & Capabilities (2)

  • A new update status, `processing`, has been added
  • Add fields `startedAt` and `finishedAt` information on the route `/dumps/{dump_id}/status`.

โšก Performance & Enhancements (6)

  • Criterion `words` is available
  • Search performance improvements
  • `attributesToHighlight` now highlights matches inside arrays and objects
  • Phrase search (`"` around words in a search query)
  • Reduced RAM usage during indexation
  • Removed the limit of 200 indexes per database

๐Ÿ”ง Bug Fixes & Patches (6)

  • Enhanced logging capabilities with `MEILI_LOG_LEVEL` environment variable and `--log-level` option. Debug level now outputs query and search results
  • Fix dumps bug that would exclude attributes not present in `displayedAttributes` from the dump file
  • Fix error on snapshots when the user enters a wrong path
  • Fix number of calculated hits when a distinct field is set
  • Fix CORS error when authentication is missing
  • Windows instances only take as much space as necessary now
๐Ÿ“„ View Raw Release Notes (Original Developer Log)
## Breaking changes - The index setting `attributesForFaceting` has been renamed to `filterableAttributes` - The `filters` and `facetsFilter` search parameters are replaced by `filter` To use the `filter` search parameter, you must add the attribute you want to filter on to the `filterableAttributes` index setting. Only use the `=` syntax (e.g. `genres = comedy`). Filter expressions using the `:` syntax (e.g. `genres: comedy`) are deprecated. Filter expressions can be combined as strings or nested arrays: - string: โ€จ`"filter": "genre = comedy AND price > 13"โ€จ` - array: โ€จ`"filter": ["genre = comedy", "price > 13 "]โ€จ` - When using the `filter` search parameter on an array, the operator `!=` will only return results that do not contain the value - The new default ranking rules are: ```json โ€จ[ "words", "typo", "proximity", "attribute", "exactness" ] ``` - `fieldsDistribution` has been renamed to `fieldDistribution` - Rename `MAX_MDB_SIZE` environment variable and `--max-mdb-size` option flag to `MAX_INDEX_SIZE` and `--max-index-size` - In the route `/version`, `buildDate` is now named `commitDate` and format has changed. MeiliSearch is now reproducible ## Improvements - New Web UI - Facets with numbers - Criterion `words` is available - Search performance improvements - `attributesToHighlight` now highlights matches inside arrays and objects - Phrase search (`"` around words in a search query) - Reduced RAM usage during indexation - Removed the limit of 200 indexes per database - Support typo on the first letter - Facet distribution also works on arrays - Enhanced logging capabilities with `MEILI_LOG_LEVEL` environment variable and `--log-level` option. Debug level now outputs query and search results - Analytics (Amplitude and Sentry) are now unified and can be disabled at once with `MEILI_NO_ANALYTICS` and `--no-analytics` flag - Improved `exactness` ranking rule - A new update status, `processing`, has been added - Add fields `startedAt` and `finishedAt` information on the route `/dumps/{dump_id}/status`. - Cropping is now consistent - Users can specify the payload limit size unit (e.g. Kb, Mb, Gb) - Improve `/stats` route speed - Improve compilation time with a caching strategy - Renamed branch `master` into `main`. - Improved README ## Fixes - Fix dumps bug that would exclude attributes not present in `displayedAttributes` from the dump file - Fix error on snapshots when the user enters a wrong path - Fix number of calculated hits when a distinct field is set - Fix CORS error when authentication is missing - Windows instances only take as much space as necessary now