Skip to main content
Meilisearch periodically introduces new experimental features. Experimental features are not always ready for production, but offer functionality that might benefit some users. An experimental feature’s API can change significantly and become incompatible between releases. Keep this in mind when using experimental features in a production environment. Meilisearch makes experimental features available expecting they will become stable in a future release, but this is not guaranteed.

​
Activating experimental features

Experimental features fall into two groups based on how they are activated or deactivated:
  1. Those that are activated at launch with a command-line flag or environment variable
  2. Those that are activated with the /experimental-features API route.

​
Activating experimental features at launch

Some experimental features can be activated at launch, for example with a command-line flag: 
./meilisearch --experimental-enable-metrics
Flags and environment variables for experimental features are not included in the regular configuration options list. Instead, consult the specific documentation page for the feature you are interested in, which can be found in the experimental section. Command-line flags for experimental features are always prefixed with --experimental. Environment variables for experimental features are always prefixed with MEILI_EXPERIMENTAL. Activating or deactivating experimental features this way requires you to relaunch Meilisearch.

​
Activating experimental features during runtime

Some experimental features can be activated via an HTTP call using the /experimental-features API route: 
curl \
  -X PATCH 'MEILISEARCH_URL/experimental-features/' \
  -H 'Content-Type: application/json'  \
  --data-binary '{
    "metrics": true
  }'
Activating or deactivating experimental features this way does not require you to relaunch Meilisearch.

​
Current experimental features

NameDescriptionHow to configure
Limit task batch sizeLimits number of tasks processed in a single batchCLI flag or environment variable
Log customizationCustomize log output and set up log streamsCLI flag or environment variable, API route
Metrics APIExposes Prometheus-compatible analytics dataCLI flag or environment variable, API route
Reduce indexing memory usageOptimizes indexing performanceCLI flag or environment variable
Replication parametersAlters task processing for clustering compatibilityCLI flag or environment variable
Search queue sizeConfigure maximum number of concurrent search requestsCLI flag or environment variable
Drop search afterDrop irrelevant search requests after a configurable timeout (default: 60s)CLI flag or environment variable
Searches per coreConfigure number of concurrent search requests per CPU core (default: 4)CLI flag or environment variable
CONTAINS filter operatorEnables usage of CONTAINS with the filter search parameterCLI flag or environment variable, API route
Edit documents with functionUse a RHAI function to edit documents directly in the Meilisearch databaseAPI route
/network routeEnable /network routeAPI route
Dumpless upgradeUpgrade Meilisearch without generating a dumpAPI route
Composite embeddersEnable composite embeddersAPI route
Chat completionsEnable chat completion capabilitiesAPI route
Get task documents routeEnable route to retrieve documents from tasksAPI route
Search query embedding cacheEnable a cache for search query embeddingsCLI flag or environment variable
Uncompressed snapshotsDisable snapshot compactionCLI flag or environment variable
Maximum batch payload sizeLimit batch payload sizeCLI flag or environment variable
Multimodal searchEnable multimodal searchAPI route
Disable new indexerUse previous settings indexerCLI flag or environment variable
Allowed IP networksOverride default IP policy with allowed CIDR rangesCLI flag or environment variable
Search personalizationEnables search personalizationCLI flag or environment variable