diff --git a/gsk/gskrendernodeimpl.c b/gsk/gskrendernodeimpl.c
index aef8481e8e..b15d2885f0 100644
--- a/gsk/gskrendernodeimpl.c
+++ b/gsk/gskrendernodeimpl.c
@@ -6984,13 +6984,16 @@ gsk_subsurface_node_class_init (gpointer g_class,
 }
 
 /**
- * gsk_subsurface_node_new:
+ * gsk_subsurface_node_new: (skip)
  * @child: The child to divert to a subsurface
  * @subsurface: (nullable): the subsurface to use
  *
  * Creates a `GskRenderNode` that will possibly divert the child
  * node to a subsurface.
  *
+ * Note: since subsurfaces are currently private, these nodes cannot
+ * currently be created outside of GTK. See [class@Gtk.GraphicsOffload].
+ *
  * Returns: (transfer full) (type GskSubsurfaceNode): A new `GskRenderNode`
  *
  * Since: 4.14
@@ -7040,7 +7043,7 @@ gsk_subsurface_node_get_child (const GskRenderNode *node)
 }
 
 /**
- * gsk_subsurface_node_get_subsurface:
+ * gsk_subsurface_node_get_subsurface: (skip)
  * @node: (type GskDebugNode): a debug `GskRenderNode`
  *
  * Gets the subsurface that was set on this node