diff --git a/doc/substitute-nvim.txt b/doc/substitute-nvim.txt
index a580be9..06eee6d 100644
--- a/doc/substitute-nvim.txt
+++ b/doc/substitute-nvim.txt
@@ -206,6 +206,30 @@ Will ask for confirmation for each substitutions.
 Will require that there be word boundaries on each match (eg: `\<word\>`
 instead of `word`).
 
+                                             *substitute-nvim-`range.motion1`*
+
+`range.motion1`                        Default : `false`
+
+
+This will use this motion for the first motion of range substitution.
+
+eg. `lua require('substitute.range').operator({ motion1 = 'iW' })` will select
+inner WORD as subject of substitution.
+
+                                             *substitute-nvim-`range.motion2`*
+
+`range.motion2`                        Default : `false`
+
+
+This will use this motion for the second motion of range substitution.
+
+eg. `lua require('substitute.range').operator({ motion2 = 'ap' })` will select
+around paragraph as range of substitution.
+
+You can combine `motion1` and `motion2` : `lua
+require('substitute.range').operator({ motion1='iw', motion2 = 'ap' })` will
+prepare substitution for inner word around paragraph.
+
 INTEGRATION ~
 
 tpope/vim-abolish ~