From f6dd9227d6e13bed7178d3560ee55ebdc245302e Mon Sep 17 00:00:00 2001 From: gui machiavelli Date: Thu, 9 Oct 2025 18:44:14 +0200 Subject: [PATCH 1/3] address user feedback regarding document templates and custom embedders --- .../search_with_user_provided_embeddings.mdx | 4 ++++ reference/api/settings.mdx | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/learn/ai_powered_search/search_with_user_provided_embeddings.mdx b/learn/ai_powered_search/search_with_user_provided_embeddings.mdx index 1fb3219ecb..ea487edbed 100644 --- a/learn/ai_powered_search/search_with_user_provided_embeddings.mdx +++ b/learn/ai_powered_search/search_with_user_provided_embeddings.mdx @@ -28,6 +28,10 @@ curl \ }' ``` + +Embedders with `source: userProvided` are the incompatible with `documentTemplate` and `documentTemplateMaxBytes`. + + ## Add documents to Meilisearch Next, use [the `/documents` endpoint](/reference/api/documents?utm_campaign=vector-search&utm_source=docs&utm_medium=vector-search-guide) to upload vectorized documents. Place vector data in your documents' `_vectors` field: diff --git a/reference/api/settings.mdx b/reference/api/settings.mdx index b13f4297f2..d59e41089b 100644 --- a/reference/api/settings.mdx +++ b/reference/api/settings.mdx @@ -2668,7 +2668,7 @@ This field is incompatible with `rest` and `userProvided` embedders. ##### `documentTemplate` -`documentTemplate` is a string containing a [Liquid template](https://shopify.github.io/liquid/basics/introduction). Meillisearch interpolates the template for each document and sends the resulting text to the embedder. The embedder then generates document vectors based on this text. +`documentTemplate` is a string containing a [Liquid template](https://shopify.github.io/liquid/basics/introduction). Meillisearch interpolates the template for each document and sends the resulting text to the embedder. The embedder then generates document vectors based on this text. This only happens when Meilisearch auto-generates embeddings—if you are using custom embedders, you must create an embedding generation pipeline outside of Meilisearch. You may use the following context values: From d90393706ea3ef5cdb25a6953823218bf3334b96 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Thu, 9 Oct 2025 16:45:02 +0000 Subject: [PATCH 2/3] Update code samples [skip ci] --- snippets/samples/code_samples_export_post_1.mdx | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/snippets/samples/code_samples_export_post_1.mdx b/snippets/samples/code_samples_export_post_1.mdx index bd10c58820..c970a6365a 100644 --- a/snippets/samples/code_samples_export_post_1.mdx +++ b/snippets/samples/code_samples_export_post_1.mdx @@ -13,4 +13,11 @@ curl \ } }' ``` + +```java Java +Map indexes = new HashMap<>(); +indexes.put("*", ExportIndexFilter.builder().overrideSettings(true).build()); +ExportRequest request = ExportRequest.builder().url("TARGET_INSTANCE_URL").indexes(indexes).build(); +client.export(request); +``` \ No newline at end of file From 1904f2203b24c437686d6b2792c26ab6d0b9acb3 Mon Sep 17 00:00:00 2001 From: gui machiavelli Date: Mon, 13 Oct 2025 13:25:26 +0200 Subject: [PATCH 3/3] improve wording --- .../ai_powered_search/search_with_user_provided_embeddings.mdx | 2 +- reference/api/settings.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/learn/ai_powered_search/search_with_user_provided_embeddings.mdx b/learn/ai_powered_search/search_with_user_provided_embeddings.mdx index ea487edbed..64e5d881aa 100644 --- a/learn/ai_powered_search/search_with_user_provided_embeddings.mdx +++ b/learn/ai_powered_search/search_with_user_provided_embeddings.mdx @@ -29,7 +29,7 @@ curl \ ``` -Embedders with `source: userProvided` are the incompatible with `documentTemplate` and `documentTemplateMaxBytes`. +Embedders with `source: userProvided` are incompatible with `documentTemplate` and `documentTemplateMaxBytes`. ## Add documents to Meilisearch diff --git a/reference/api/settings.mdx b/reference/api/settings.mdx index d59e41089b..6e355d52cd 100644 --- a/reference/api/settings.mdx +++ b/reference/api/settings.mdx @@ -2668,7 +2668,7 @@ This field is incompatible with `rest` and `userProvided` embedders. ##### `documentTemplate` -`documentTemplate` is a string containing a [Liquid template](https://shopify.github.io/liquid/basics/introduction). Meillisearch interpolates the template for each document and sends the resulting text to the embedder. The embedder then generates document vectors based on this text. This only happens when Meilisearch auto-generates embeddings—if you are using custom embedders, you must create an embedding generation pipeline outside of Meilisearch. +`documentTemplate` is a string containing a [Liquid template](https://shopify.github.io/liquid/basics/introduction). When using an embedding generation service such as OpenAI, Meillisearch interpolates the template for each document and sends the resulting text to the embedder. The embedder then generates document vectors based on this text. If used with a custom embedder, Meilisearch will return an error. You may use the following context values: