diff --git a/docs/examples/custom-node/OutputNode.vue b/docs/examples/custom-node/OutputNode.vue
index d04a719e2..84045efaa 100644
--- a/docs/examples/custom-node/OutputNode.vue
+++ b/docs/examples/custom-node/OutputNode.vue
@@ -1,7 +1,7 @@
 <script setup>
-import { Handle, Position, useHandleConnections, useNodesData } from '@vue-flow/core'
+import { Handle, Position, useNodeConnections, useNodesData } from '@vue-flow/core'
 
-const connections = useHandleConnections({
+const connections = useNodeConnections({
   type: 'target',
 })
 
diff --git a/docs/examples/layout/ProcessNode.vue b/docs/examples/layout/ProcessNode.vue
index 7641d8743..ec2c0f2ce 100644
--- a/docs/examples/layout/ProcessNode.vue
+++ b/docs/examples/layout/ProcessNode.vue
@@ -1,6 +1,6 @@
 <script setup>
 import { computed, toRef } from 'vue'
-import { Handle, useHandleConnections } from '@vue-flow/core'
+import { Handle, useNodeConnections } from '@vue-flow/core'
 
 const props = defineProps({
   data: {
@@ -15,11 +15,11 @@ const props = defineProps({
   },
 })
 
-const sourceConnections = useHandleConnections({
+const sourceConnections = useNodeConnections({
   type: 'target',
 })
 
-const targetConnections = useHandleConnections({
+const targetConnections = useNodeConnections({
   type: 'source',
 })
 
diff --git a/docs/examples/math/ResultNode.vue b/docs/examples/math/ResultNode.vue
index 999f1ab82..52ab628ca 100644
--- a/docs/examples/math/ResultNode.vue
+++ b/docs/examples/math/ResultNode.vue
@@ -1,6 +1,6 @@
 <script setup>
 import { computed } from 'vue'
-import { Handle, Position, useHandleConnections, useNodeConnections, useNodesData } from '@vue-flow/core'
+import { Handle, Position, useNodeConnections, useNodesData } from '@vue-flow/core'
 
 defineProps(['id'])
 
@@ -12,7 +12,7 @@ const mathFunctions = {
 }
 
 // Get the source connections of the result node. In this example it's only one operator node.
-const sourceConnections = useHandleConnections({
+const sourceConnections = useNodeConnections({
   // type target means all connections where *this* node is the target
   // that means we go backwards in the graph to find the source of the connection(s)
   type: 'target',
diff --git a/docs/src/examples/math.md b/docs/src/examples/math.md
index dd483ad50..d3cdfb254 100644
--- a/docs/src/examples/math.md
+++ b/docs/src/examples/math.md
@@ -1,8 +1,8 @@
 # Math Operation
 
-This example demonstrates how to use the different composables like `useHandleConnections` or `useNodesData` to create a data flow between nodes.
+This example demonstrates how to use the different composables like `useNodeConnections` or `useNodesData` to create a data flow between nodes.
 
-In this example we use nodes to create a simple math operation, where the user can input two numbers and select an operation to perform.
+We use nodes to create a simple math operation, where the user can input two numbers and select an operation to perform.
 
 <div class="mt-6">
   <Repl example="math"></Repl>
diff --git a/docs/src/guide/composables.md b/docs/src/guide/composables.md
index 1714575cd..336a90586 100644
--- a/docs/src/guide/composables.md
+++ b/docs/src/guide/composables.md
@@ -102,8 +102,7 @@ const connections = useHandleConnections({
 ## [useNodeConnections](/typedocs/functions/useNodeConnections)
 
 `useNodeConnections` provides you with an array of connections that are connected to a specific node.
-This composable is especially useful when you want to get all connections (of either type `source` or `target`) of a node 
-instead of just the connections of a specific `<Handle>`.
+This composable is especially useful when you want to get all connections (of either type `source` or `target`) of a node.
 
 ```ts
 import { type HandleConnection, useNodeConnections } from '@vue-flow/core'
@@ -119,6 +118,10 @@ const sourceConnections = useNodeConnections({
   type: 'source',
 })
 
+const handleConnections = useNodeConnections({
+  handleId: 'handle-1', // you can explicitly pass a handle id if you want to get connections of a specific handle
+})
+
 const connections = useNodeConnections({
   nodeId: '1', // you can explicitly pass a node id, otherwise it's used from the `NodeId  injection
   type: 'target',