diff --git a/packages/core/src/types/edge.ts b/packages/core/src/types/edge.ts
index 5d1a97e3..f90a5963 100644
--- a/packages/core/src/types/edge.ts
+++ b/packages/core/src/types/edge.ts
@@ -103,7 +103,7 @@ export interface DefaultEdge<
   template?: EdgeComponent
   /** Additional data that is passed to your custom components */
   data?: Data
-  /** contextual and custom events of edge */
+  /** @deprecated will be removed in the next major version */
   events?: Partial<EdgeEventsHandler<CustomEvents>>
   /** Aria label for edge (a11y) */
   zIndex?: number
@@ -159,6 +159,7 @@ export type GraphEdge<
   sourceNode: GraphNode
   targetNode: GraphNode
   data: Data
+  /** @deprecated will be removed in the next major version */
   events: Partial<EdgeEventsHandler<CustomEvents>>
   type: Type
 } & EdgePositions
diff --git a/packages/core/src/types/node.ts b/packages/core/src/types/node.ts
index 02d92517..16342df7 100644
--- a/packages/core/src/types/node.ts
+++ b/packages/core/src/types/node.ts
@@ -114,6 +114,7 @@ export interface GraphNode<
   dragging: boolean
   initialized: boolean
   data: Data
+  /** @deprecated will be removed in the next major version */
   events: Partial<NodeEventsHandler<CustomEvents>>
   type: Type
 }