diff --git a/lms/envs/common.py b/lms/envs/common.py
index 038711a5d4..c05e2ce9f0 100644
--- a/lms/envs/common.py
+++ b/lms/envs/common.py
@@ -1210,7 +1210,10 @@ XBLOCK_FS_STORAGE_PREFIX = None
 
 # .. setting_name: XBLOCK_SETTINGS
 # .. setting_default: {}
-# .. setting_description: Dictionary containing server-wide configuration of XBlocks on a per-type basis
+# .. setting_description: Dictionary containing server-wide configuration of XBlocks on a per-type basis.
+#     By default, keys should match the XBlock `block_settings_key` attribute/property. If the attribute/property
+#     is not defined, use the XBlock class name. Check `common.lib.xmodule.xmodule.services.SettingsService`
+#     for more reference.
 XBLOCK_SETTINGS = {}
 
 ############# ModuleStore Configuration ##########