diff --git a/docs/reference/setup/secure-settings.asciidoc b/docs/reference/setup/secure-settings.asciidoc
index f8631c4fa53fd..e3337c86c3686 100644
--- a/docs/reference/setup/secure-settings.asciidoc
+++ b/docs/reference/setup/secure-settings.asciidoc
@@ -8,6 +8,9 @@ tool to manage the settings in the keystore.
 
 NOTE: All commands here should be run as the user which will run elasticsearch.
 
+NOTE: Only some settings are designed to be read from the keystore. See
+documentation for each setting to see if it is supported as part of the keystore.
+
 [float]
 [[creating-keystore]]
 === Creating the keystore