diff --git a/doc/help/commands.asciidoc b/doc/help/commands.asciidoc
index f87c431ff..02427b97b 100644
--- a/doc/help/commands.asciidoc
+++ b/doc/help/commands.asciidoc
@@ -1438,6 +1438,8 @@ Syntax: +:scroll 'direction'+
 
 Scroll the current tab in the given direction.
 
+Note you can use `:run-with-count` to have a keybinding with a bigger scroll increment.
+
 ==== positional arguments
 * +'direction'+: In which direction to scroll (up/down/left/right/top/bottom).
 
diff --git a/doc/help/settings.asciidoc b/doc/help/settings.asciidoc
index 8ec1d521b..6e2386313 100644
--- a/doc/help/settings.asciidoc
+++ b/doc/help/settings.asciidoc
@@ -48,7 +48,7 @@
 |<<ui-user-stylesheet,user-stylesheet>>|User stylesheet to use (absolute filename or filename relative to the config directory). Will expand environment variables.
 |<<ui-hide-scrollbar,hide-scrollbar>>|Hide the main scrollbar.
 |<<ui-css-media-type,css-media-type>>|Set the CSS media type.
-|<<ui-smooth-scrolling,smooth-scrolling>>|Whether to enable smooth scrolling for webpages.
+|<<ui-smooth-scrolling,smooth-scrolling>>|Whether to enable smooth scrolling for webpages. Note smooth scrolling does not work with the :scroll-px command.
 |<<ui-remove-finished-downloads,remove-finished-downloads>>|Number of milliseconds to wait before removing finished downloads. Will not be removed if value is -1.
 |<<ui-hide-statusbar,hide-statusbar>>|Whether to hide the statusbar unless a message is shown.
 |<<ui-statusbar-padding,statusbar-padding>>|Padding for statusbar (top, bottom, left, right).
@@ -655,7 +655,7 @@ This setting is only available with the QtWebKit backend.
 
 [[ui-smooth-scrolling]]
 === smooth-scrolling
-Whether to enable smooth scrolling for webpages.
+Whether to enable smooth scrolling for webpages. Note smooth scrolling does not work with the :scroll-px command.
 
 Valid values:
 
diff --git a/qutebrowser/browser/commands.py b/qutebrowser/browser/commands.py
index d728afa55..2c2f0fdd2 100644
--- a/qutebrowser/browser/commands.py
+++ b/qutebrowser/browser/commands.py
@@ -595,6 +595,9 @@ class CommandDispatcher:
     def scroll(self, direction: typing.Union[str, int], count=1):
         """Scroll the current tab in the given direction.
 
+        Note you can use `:run-with-count` to have a keybinding with a bigger
+        scroll increment.
+
         Args:
             direction: In which direction to scroll
                        (up/down/left/right/top/bottom).
diff --git a/qutebrowser/config/configdata.py b/qutebrowser/config/configdata.py
index 32ff9268e..dab540934 100644
--- a/qutebrowser/config/configdata.py
+++ b/qutebrowser/config/configdata.py
@@ -351,7 +351,8 @@ def data(readonly=False):
 
             ('smooth-scrolling',
              SettingValue(typ.Bool(), 'false'),
-             "Whether to enable smooth scrolling for webpages."),
+             "Whether to enable smooth scrolling for web pages. Note smooth "
+             "scrolling does not work with the :scroll-px command."),
 
             ('remove-finished-downloads',
              SettingValue(typ.Int(minval=-1), '-1'),