diff --git a/docs/command-line.md b/docs/command-line.md
index c1568891..a629b9a9 100644
--- a/docs/command-line.md
+++ b/docs/command-line.md
@@ -72,6 +72,7 @@ Click one of the following links to take you straight to that option - or scroll
` --shard-count`
` --shard-index`
` --allow-running-no-tests`
+ ` --verbosity`
@@ -478,6 +479,19 @@ run, e.g. if the binary was compiled with no tests, or the provided test
spec matched no tests. This flag overrides that, so a test run with no
tests still returns 0.
+## Output verbosity
+```
+-v, --verbosity
+```
+
+Changing verbosity might change how much details Catch2's reporters output.
+However, you should consider changing the verbosity level as a _suggestion_.
+Not all reporters support all verbosity levels, e.g. because the reporter's
+format cannot meaningfully change. In that case, the verbosity level is
+ignored.
+
+Verbosity defaults to _normal_.
+
---