From c20f36ffb5821ff38cf444926f83ea68ddd15403 Mon Sep 17 00:00:00 2001 From: Kofi B Date: Fri, 28 Feb 2025 18:29:28 +0900 Subject: [PATCH] [DOCS] Update put mapping intro (#120248) --- docs/reference/indices/put-mapping.asciidoc | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/reference/indices/put-mapping.asciidoc b/docs/reference/indices/put-mapping.asciidoc index 479bdff22a80c..a377f92d6cfd3 100644 --- a/docs/reference/indices/put-mapping.asciidoc +++ b/docs/reference/indices/put-mapping.asciidoc @@ -10,8 +10,14 @@ For the most up-to-date API details, refer to {api-es}/group/endpoint-indices[Index APIs]. -- -Adds new fields to an existing data stream or index. You can also use this -API to change the search settings of existing fields. +You can use this API to: + +* Add new fields to an existing index +* Change the search settings of existing fields + +NOTE: Elasticsearch does not allow in-place field type changes. If you need to change a field’s type, you must create a new index with the updated mapping and <> the data. + + For data streams, these changes are applied to all backing indices by default.