diff --git a/.changeset/curly-kangaroos-clap.md b/.changeset/curly-kangaroos-clap.md
new file mode 100644
index 00000000..c2e617fc
--- /dev/null
+++ b/.changeset/curly-kangaroos-clap.md
@@ -0,0 +1,5 @@
+---
+'@xyflow/react': patch
+---
+
+Improve `onNodesChange` docs