diff --git a/kitty/options/definition.py b/kitty/options/definition.py
index 4e7118c4b..f85bf79a7 100644
--- a/kitty/options/definition.py
+++ b/kitty/options/definition.py
@@ -402,9 +402,9 @@ opt('url_style', 'curly',
 opt('open_url_with', 'default',
     option_type='to_cmdline',
     long_text='''
-The program to open clicked URLs. The special value :code:`default` means to
-use the operating system's default URL handler (:program:`open` on macOS and
-:program:`xdg-open` on Linux).
+The program to open clicked URLs. The special value :code:`default` with first look for any URL handlers defined via
+the :doc:`open_actions` facility and if non are found, it will use the Operating System's
+default URL handler (:program:`open` on macOS and :program:`xdg-open` on Linux).
 '''
     )