diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 24a7249151..aaf4227ba1 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -3496,18 +3496,34 @@ G_GNUC_END_IGNORE_DEPRECATIONS
 							     0, G_MAXINT, 1,
 							     GTK_PARAM_READABLE | G_PARAM_DEPRECATED));
 G_GNUC_BEGIN_IGNORE_DEPRECATIONS
+  /**
+   * GtkWidget:cursor-color:
+   *
+   * The color with which to draw the insertion cursor in entries and
+   * text views.
+   *
+   * Deprecated: 3.20: Use the caret-color CSS property
+   */
   gtk_widget_class_install_style_property (klass,
 					   g_param_spec_boxed ("cursor-color",
 							       P_("Cursor color"),
 							       P_("Color with which to draw insertion cursor"),
 							       GDK_TYPE_COLOR,
-							       GTK_PARAM_READABLE));
+							       GTK_PARAM_READABLE|G_PARAM_DEPRECATED));
+  /**
+   * GtkWidget:secondary-cursor-color:
+   *
+   * The color with which to draw the secondary insertion cursor in entries and
+   * text views when editing mixed right-to-left and left-to-right text.
+   *
+   * Deprecated: 3.20: Use the -gtk-secondary-caret-color CSS property
+   */
   gtk_widget_class_install_style_property (klass,
 					   g_param_spec_boxed ("secondary-cursor-color",
 							       P_("Secondary cursor color"),
 							       P_("Color with which to draw the secondary insertion cursor when editing mixed right-to-left and left-to-right text"),
 							       GDK_TYPE_COLOR,
-							       GTK_PARAM_READABLE));
+							       GTK_PARAM_READABLE|G_PARAM_DEPRECATED));
 G_GNUC_END_IGNORE_DEPRECATIONS
   gtk_widget_class_install_style_property (klass,
 					   g_param_spec_float ("cursor-aspect-ratio",