diff --git a/docs/reference/mapping/params/analyzer.asciidoc b/docs/reference/mapping/params/analyzer.asciidoc
index 4c5d7cda7337a..e845fe79b9d96 100644
--- a/docs/reference/mapping/params/analyzer.asciidoc
+++ b/docs/reference/mapping/params/analyzer.asciidoc
@@ -19,6 +19,9 @@ We recommend testing analyzers before using them in production. See
 <<test-analyzer>>.
 ====
 
+TIP: The `analyzer` setting can *not* be updated on existing fields
+using the <<indices-put-mapping,PUT mapping API>>.
+
 [[search-quote-analyzer]]
 ==== `search_quote_analyzer`
 
@@ -94,6 +97,9 @@ GET my-index-000001/_search
 }
 --------------------------------------------------
 
+TIP: The `search_quote_analyzer` setting can be updated on existing fields
+using the <<indices-put-mapping,PUT mapping API>>.
+
 <1> `my_analyzer` analyzer which tokens all terms including stop words
 <2> `my_stop_analyzer` analyzer which removes stop words
 <3> `analyzer` setting that points to the `my_analyzer` analyzer which will be used at index time