diff --git a/docs/mctl_list_firmware.md b/docs/mctl_list_firmware.md
index f2e0457a..8f9e83a7 100644
--- a/docs/mctl_list_firmware.md
+++ b/docs/mctl_list_firmware.md
@@ -14,7 +14,7 @@ mctl list firmware [flags]
       --component string          the component type or slug (bmc|bios|nic..)
   -V, --firmware-version string   firmware version
   -h, --help                      help for firmware
-      --limit int                 limit results returned (default 10)
+      --limit int                 limit results returned. Max value is 1000 (hard limit set in fleetdb). To list more than 1000, you must query each page (with '--page') individually (default 10)
   -m, --model string              filter by model
       --page int                  limit results to page (for use with --limit)
   -s, --server string             ID of the server