diff --git a/docs/src/main/sphinx/functions/map.md b/docs/src/main/sphinx/functions/map.md
index c8cfb508ba86..8ff699fb7041 100644
--- a/docs/src/main/sphinx/functions/map.md
+++ b/docs/src/main/sphinx/functions/map.md
@@ -2,7 +2,9 @@
 
 ## Subscript operator: \[\]
 
-The `[]` operator is used to retrieve the value corresponding to a given key from a map:
+The `[]` operator is used to retrieve the value corresponding to a given key from a map.
+This operator throws an error if the key is not contained in the map.
+See also `element_at` function that returns `NULL` in such case.
 
 ```
 SELECT name_to_age_map['Bob'] AS bob_age;