diff --git a/man/userdbctl.xml b/man/userdbctl.xml
index 9a69f33edbd..c86937760f3 100644
--- a/man/userdbctl.xml
+++ b/man/userdbctl.xml
@@ -59,7 +59,13 @@
user friendly, human readable output is generated; if table a minimal, tabular
output is generated; if json a JSON formatted output is generated. Defaults to
friendly if a user/group is specified on the command line,
- table otherwise.
+ table otherwise.
+
+ Note that most output formats do not show all available information. In particular,
+ classic and table show only the most important fields. Various
+ modes also do not show password hashes. Use json to view all fields, including
+ any authentication fields.
+