diff --git a/Documentation/btrfs-balance.txt b/Documentation/btrfs-balance.txt
index 89fd4490..e1ad6511 100644
--- a/Documentation/btrfs-balance.txt
+++ b/Documentation/btrfs-balance.txt
@@ -102,6 +102,11 @@ specified as <start..end>.
 Convert each selected block group to the given profile name identified by
 parameters.
 
+*limit*::::
+Process only given number of chunks, after all filters apply. This can be used
+to specifically target a chunk in connection with other filters (drange,
+vrange) or just simply limit the amount of work done by a single balance run.
+
 *soft*::::
 Takes no parameters. Only has meaning when converting between profiles.
 When doing convert from one profile to another and soft mode is on,