diff --git a/kitty/options/definition.py b/kitty/options/definition.py
index 1ef374e54..b5caace07 100644
--- a/kitty/options/definition.py
+++ b/kitty/options/definition.py
@@ -300,7 +300,9 @@
 text in the cell it is over and the text will be rendered with the background
 color of the cell. Note that if the program running in the terminal sets a
 cursor color, this takes precedence. Also, the cursor colors are modified if
-the cell background and foreground colors have very low contrast.
+the cell background and foreground colors have very low contrast. Note that some
+themes set this value, so if you want to override it, place your value after
+the lines where the theme file is included.
 '''
     )
 
@@ -310,7 +312,8 @@
 The color of text under the cursor. If you want it rendered with the
 background color of the cell underneath instead, use the special keyword:
 background. Note that if :opt:`cursor` is set to :code:`none` then this option
-is ignored.
+is ignored. Note that some themes set this value, so if you want to override it,
+place your value after the lines where the theme file is included.
 '''
     )