✨ 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:

{
  "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 and other models

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 ❤️