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.
โก 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 โค๏ธ