diff --git a/gst/gstindex.c b/gst/gstindex.c
index f606fbffd3..27d4b8b59d 100644
--- a/gst/gstindex.c
+++ b/gst/gstindex.c
@@ -695,6 +695,12 @@ gst_index_gtype_resolver (GstIndex * index, GstObject * writer,
  * to a string. That string will be used to register or look up an id
  * in the index.
  *
+ * <note>
+ * The caller must not hold @writer's #GST_OBJECT_LOCK, as the default
+ * resolver may call functions that take the object lock as well, and
+ * the lock is not recursive.
+ * </note>
+ *
  * Returns: TRUE if the writer would be mapped to an id.
  */
 gboolean