diff --git a/docs/reference/mapping/params/multi-fields.asciidoc b/docs/reference/mapping/params/multi-fields.asciidoc index e18ee3b1823c2..35d448ec3a267 100644 --- a/docs/reference/mapping/params/multi-fields.asciidoc +++ b/docs/reference/mapping/params/multi-fields.asciidoc @@ -58,10 +58,12 @@ GET my-index-000001/_search <2> The `city` field can be used for full text search. <3> The `city.raw` field can be used for sorting and aggregations -NOTE: Multi-fields do not change the original `_source` field. +You can add multi-fields to an existing field using the +<>. -TIP: New multi-fields can be added to existing -fields using the <>. +A multi-field mapping is completely separate from the parent field's mapping. A +multi-field doesn't inherit any mapping options from its parent field. +Multi-fields don't change the original `_source` field. ==== Multi-fields with multiple analyzers