diff --git a/docs/setup/settings.asciidoc b/docs/setup/settings.asciidoc
index c2cbefb2dcbf..c10d9b938a40 100644
--- a/docs/setup/settings.asciidoc
+++ b/docs/setup/settings.asciidoc
@@ -122,7 +122,8 @@ which is proxied through the Kibana server.
 
 `kibana.index:`:: *Default: ".kibana"* Kibana uses an index in Elasticsearch to
 store saved searches, visualizations and dashboards. Kibana creates a new index
-if the index doesn’t already exist.
+if the index doesn’t already exist. If you configure a custom index, the name must 
+be lowercase, and conform to {es} {ref}/indices-create-index.html[index name limitations].
 
 `logging.dest:`:: *Default: `stdout`* Enables you specify a file where Kibana
 stores log output.