Meilisearch v1.26.0stable Released Nov 17, 2025
Impact Score: 5/10

Meilisearch: v1.26.0 ๐Ÿ›

Source available โ€” automated, not human-reviewed

Component: meilisearch ยท Channel: stable. Automated analysis, not a compatibility certification. How this works.

Analysis updated: 2026-11-01.

Compatibility not verified โ€” check source notes
๐Ÿ“„ .MD
โšก Executive Summary (TL;DR)

Meilisearch v1.26.0. Source highlight: Allow to attach custom metadata in the document addition or update tasks

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.

โœจ New Features & Capabilities (1)

  • To use this feature, add the `customMetadata` query parameter to any supported route:
๐Ÿ“„ View Raw Release Notes (Original Developer Log)
# โœจ Enhancements ## Allow to attach custom metadata in the document addition or update tasks - To make it easier to keep track of which documents were processed by Meilisearch, it is now possible to attach an arbitrary string to all routes that create document-related tasks. - Tasks created with this custom metadata will display the passed metadata when accessed by the tasks route or sent in webhooks. - To use this feature, add the `customMetadata` query parameter to any supported route: ``` POST /indexes/{indexUid}/documents?customMetadata=my-metadata-for-the-task ``` - Note that, as usual for query parameters, the value of the parameter must be URL-encoded. - List of supported routes: ``` POST /indexes/{indexUid}/documents PUT /indexes/{indexUid}/documents DELETE /indexes/{indexUid}/documents/{documentId} POST /indexes/{indexUid}/documents/delete-batch POST /indexes/{indexUid}/documents/delete POST /indexes/{indexUid}/documents/edit DELETE /indexes/{indexUid}/documents ``` - Sample output of `GET /tasks` for tasks with metadata: ```json { "results": [ { "uid": 37, "batchUid": 37, "indexUid": "mieli", "status": "succeeded", "type": "documentDeletion", "canceledBy": null, "details": { "deletedDocuments": 31944 }, "error": null, "duration": "PT0.511099S", "enqueuedAt": "2025-11-06T16:33:37.816237Z", "startedAt": "2025-11-06T16:33:37.821591Z", "finishedAt": "2025-11-06T16:33:38.33269Z", "customMetadata": "removeall" }, { "uid": 36, "batchUid": 36, "indexUid": "movies", "status": "succeeded", "type": "documentAdditionOrUpdate", "canceledBy": null, "details": { "receivedDocuments": 31968, "indexedDocuments": 31944 }, "error": null, "duration": "PT3.192271S", "enqueuedAt": "2025-10-30T10:31:12.896073Z", "startedAt": "2025-10-30T10:31:12.911905Z", "finishedAt": "2025-10-30T10:31:16.104176Z", "customMetadata": "foo" } ], "total": 38, "limit": 2, "from": 36, "next": 35 } ``` by @dureuill in https://github.com/meilisearch/meilisearch/pull/5963 ## Support more models for `huggingFace` embedder You can now select models with the `modernBERT` architecture when generating embeddings locally on CPU or GPU with the `huggingFace` embedder. This unlocks for instance [Ruri v3](https://huggingface.co/cl-nagoya/ruri-v3-30m) and [other models](https://huggingface.co/models?other=modernbert) by @hayatosc in https://github.com/meilisearch/meilisearch/pull/5980 ## ๐Ÿงช Experimental: embedder failure modes You can now decide to ignore some embedder-related errors. Either: 1. Errors related to a document template not rendering properly 2. Errors related to an embedding request to an embedder failing (this includes missing vectors in `userProvided` embedders) 3. Or both kinds of errors. When errors are ignored, the corresponding documents will not have embeddings, but the associated batch of tasks will not be marked as failed. Of course, ignoring errors means that it is harder to notice an issue with embedders, so use this feature parsimoniously. To enable the feature: - Customers of the Cloud, please ask the support. - OSS users, please use the `MEILI_EXPERIMENTAL_CONFIG_EMBEDDER_FAILURE_MODES` and set it to a comma-separated list of errors to ignore, with the possible values: 1. `ignore_document_template_failures` to ignore document template failures 2. `ignore_embedder_failures` to ignore embedder failures - For example: `ignore_document_template_failures,ignore_embedder_failures` ignores both kinds of failures by @dureuill in https://github.com/meilisearch/meilisearch/pull/5984 ## ๐Ÿงช Experimental: timeout control for REST embedders You can now control the duration before a REST embedder request times out. - Customers of the Cloud, please ask the support. - OSS users, please use the `MEILI_EXPERIMENTAL_REST_EMBEDDER_TIMEOUT_SECONDS`, which must be a positive integer. by @dureuill in https://github.com/meilisearch/meilisearch/pull/5984 # ๐Ÿ”ฉ Misc * Remove unused dependency `allocator-api2` by @xuhongxu96 in https://github.com/meilisearch/meilisearch/pull/5969 # ๐Ÿ‘ฅ Contributors Many thanks to our new contributors @hayatosc and @xuhongxu96 โค๏ธ