> ## Documentation Index
> Fetch the complete documentation index at: https://www.meilisearch.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Meilisearch v1.16 release notes

> Released August 4, 2025

## New Features

### Multimodal Embeddings

Index and search images alongside text documents using AI-powered multimodal embedders. This experimental feature allows you to create a common semantic representation for images, texts, and other data types, enabling searches with image queries.

Enable the feature:

```bash theme={null}
curl \
 -X PATCH 'MEILISEARCH_URL/experimental-features/' \
 -H 'Content-Type: application/json' \
 --data-binary '{
 "multimodal": true
 }'
```

Configure a multimodal embedder (example using VoyageAI):

```bash theme={null}
curl \
 -X PATCH 'MEILISEARCH_URL/indexes/INDEX_NAME/settings/embedders' \
 -H 'Content-Type: application/json' \
 --data-binary '{
 "voyage": {
 "source": "rest",
 "url": "https://api.voyageai.com/v1/multimodalembeddings",
 "apiKey": "VOYAGE_API_KEY",
 "indexingFragments": {
 "text": {
 "value": {
 "content": [
 {
 "type": "text",
 "text": "A movie titled {{doc.title}} whose description starts with {{doc.overview|truncateWords:20}}."
 }
 ]
 }
 },
 "poster": {
 "value": {
 "content": [
 {
 "type": "image_url",
 "image_url": "{{doc.poster}}"
 }
 ]
 }
 }
 },
 "searchFragments": {
 "poster": {
 "value": {
 "content": [
 {
 "type": "image_url",
 "image_url": "{{media.poster}}"
 }
 ]
 }
 },
 "image": {
 "value": {
 "content": [
 {
 "type": "image_base64",
 "image_base64": "data:{{media.image.mime}};base64,{{media.image.data}}"
 }
 ]
 }
 },
 "text": {
 "value": {
 "content": [
 {
 "type": "text",
 "text": "{{q}}"
 }
 ]
 }
 }
 },
 "request": {
 "inputs": [
 "{{fragment}}",
 "{{..}}"
 ],
 "model": "voyage-multimodal-3"
 },
 "response": {
 "data": [
 {
 "embedding": "{{embedding}}"
 },
 "{{..}}"
 ]
 }
 }
 }'
```

Search using an image URL:

```bash theme={null}
curl -X POST 'MEILISEARCH_URL/indexes/INDEX_NAME/search' \
 -H 'content-type: application/json' \
 --data-binary '{
 "media": {
 "poster": "https://image.tmdb.org/t/p/w500/pgqj7QoBPWFLLKtLEpPmFYFRMgB.jpg"
 },
 "hybrid": {
 "embedder": "voyage"
 }
 }'
```

Or perform a hybrid text search:

```bash theme={null}
curl -X POST 'MEILISEARCH_URL/indexes/INDEX_NAME/search' \
 -H 'content-type: application/json' \
 --data-binary '{
 "q": "A movie with lightsabers in space",
 "hybrid": {
 "embedder": "voyage",
 "semanticRatio": 0.5
 }
 }'
```

### Export Route for Data Migration

Transfer documents between Meilisearch instances without creating dumps or snapshots. This is particularly useful when migrating from a local machine to Meilisearch Cloud.

```bash theme={null}
curl \
 -X POST 'MEILISEARCH_URL/export' \
 -H 'Content-Type: application/json' \
 --data-binary '{
 "url": "http://localhost:7711"
 }'
```

You may optionally supply an API key if the target instance requires authentication:

```json theme={null}
{
  "url": "http://localhost:7711",
  "apiKey": "target-instance-api-key"
}
```

The export will generate a task that begins migrating data between instances. If the request fails, Meilisearch will retry automatically. You can also cancel an export task manually, though this will only interrupt the task locally.

## Improvements

### Better Nested Wildcard Support

Added support for nested wildcards in `attributes_to_search_on`, allowing more flexible search field configurations.

### Improved Geo Field Extraction

Enhanced the extraction of geographic fields from documents for more accurate geo-based filtering and search.

### CPU Utilization During Dump Import

Dump imports now use all available CPUs for faster processing.

### Live Embedder Error Display

The last embedder error is now displayed live in batches, making it easier to diagnose embedding issues.

### Fallback Instance Option

Added the ability to revert to the old indexer using a fallback instance option for compatibility purposes.

### Filters in Chat Completions

Chat completions now support filters, enabling more precise control over the results used in completions.

### Document Route Sorting

The `/documents` route now supports sorting, giving you more control over how documents are retrieved.

### Read-Only Admin Key for New Databases

New empty databases now automatically create a Read-Only Admin key to prevent accidental writes while investigating your database.

### Edition 2024 Indexer in Dumps

Dumps now use the updated edition 2024 documents indexer for better compatibility.

## Other

### Experimental Features and Configuration Changes

* A fallback instance option is available to revert to the old indexer if needed
* The `--experimental-limit-batched-tasks-total-size` environment variable now works correctly
* The `disableOnNumbers` setting is now properly affected by typo tolerance resets
* New databases include a Read-Only Admin key for safer exploration

[Find more information on GitHub](https://github.com/meilisearch/meilisearch/releases/tag/v1.16.0)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.