diff --git a/doc/help/commands.asciidoc b/doc/help/commands.asciidoc
index 0c25a8468..f12b3ba99 100644
--- a/doc/help/commands.asciidoc
+++ b/doc/help/commands.asciidoc
@@ -243,6 +243,8 @@ Open main startpage in current tab.
 === inspector
 Toggle the web inspector.
 
+Note: Due a bug in Qt, the inspector will show incorrect request headers in the network tab.
+
 [[jseval]]
 === jseval
 Syntax: +:jseval [*--quiet*] 'js-code'+
diff --git a/qutebrowser/browser/commands.py b/qutebrowser/browser/commands.py
index 538107a42..8cd1eaf6a 100644
--- a/qutebrowser/browser/commands.py
+++ b/qutebrowser/browser/commands.py
@@ -1089,7 +1089,11 @@ class CommandDispatcher:
     @cmdutils.register(instance='command-dispatcher', name='inspector',
                        scope='window')
     def toggle_inspector(self):
-        """Toggle the web inspector."""
+        """Toggle the web inspector.
+
+        Note: Due a bug in Qt, the inspector will show incorrect request
+        headers in the network tab.
+        """
         cur = self._current_widget()
         if cur.inspector is None:
             if not config.get('general', 'developer-extras'):