From d3edcd078476e460db7a0e97e901d58c4170fde2 Mon Sep 17 00:00:00 2001
From: Emma Indal <emma.indahl@gmail.com>
Date: Fri, 10 Jun 2022 13:41:56 +0200
Subject: [PATCH] add instructions for how to set a custom index template

Signed-off-by: Emma Indal <emma.indahl@gmail.com>
---
 docs/features/search/search-engines.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs/features/search/search-engines.md b/docs/features/search/search-engines.md
index f1fd4bd62b..9bb8b8c343 100644
--- a/docs/features/search/search-engines.md
+++ b/docs/features/search/search-engines.md
@@ -102,6 +102,31 @@ import { Client } from '@elastic/elastic-search';
 const client = searchEngine.newClient(options => new Client(options));
 ```
 
+#### Set custom index template
+
+The elasticsearch engine gives you the ability to set a custom index template if needed.
+
+> Index templates define settings, mappings, and aliases that can be applied automatically to new indices.
+
+```typescript
+// app/backend/src/plugins/search.ts
+const searchEngine = await ElasticSearchSearchEngine.initialize({
+  logger: env.logger,
+  config: env.config,
+});
+
+searchEngine.setIndexTemplate({
+  name: '<name-of-your-custom-template>',
+  body: {
+    index_patterns: ['<your-index-pattern>'],
+    template: {
+      mappings: {},
+      settings: {},
+    },
+  },
+});
+```
+
 ## Example configurations
 
 ### AWS