diff --git a/etc/glance-api.conf b/etc/glance-api.conf
index fa2b19596a..f6ec897f45 100644
--- a/etc/glance-api.conf
+++ b/etc/glance-api.conf
@@ -795,7 +795,10 @@
 #
 # Provide a non-negative integer value to set the number of child
 # process workers to service requests. By default, the number of CPUs
-# available is set as the value for ``workers``.
+# available is set as the value for ``workers`` limited to 8. For
+# example if the processor count is 6, 6 workers will be used, if the
+# processor count is 24 only 8 workers will be used. The limit will only
+# apply to the default value, if 24 workers is configured, 24 is used.
 #
 # Each worker process is made to listen on the port set in the
 # configuration file and contains a greenthread pool of size 1000.
diff --git a/etc/glance-registry.conf b/etc/glance-registry.conf
index 11d4320b7f..6769dbdb75 100644
--- a/etc/glance-registry.conf
+++ b/etc/glance-registry.conf
@@ -775,7 +775,10 @@
 #
 # Provide a non-negative integer value to set the number of child
 # process workers to service requests. By default, the number of CPUs
-# available is set as the value for ``workers``.
+# available is set as the value for ``workers`` limited to 8. For
+# example if the processor count is 6, 6 workers will be used, if the
+# processor count is 24 only 8 workers will be used. The limit will only
+# apply to the default value, if 24 workers is configured, 24 is used.
 #
 # Each worker process is made to listen on the port set in the
 # configuration file and contains a greenthread pool of size 1000.