diff --git a/packages/browser/src/entrypoints/lazy-recorder.ts b/packages/browser/src/entrypoints/lazy-recorder.ts
index e755fcda39..6aeefb3edd 100644
--- a/packages/browser/src/entrypoints/lazy-recorder.ts
+++ b/packages/browser/src/entrypoints/lazy-recorder.ts
@@ -1,3 +1,6 @@
+// This file is kept only for backwards compatibility.
+// In almost every case, if you are manually importing a file you should use posthog-recorder instead.
+
 // This is only here for so that users with cached recorder.ts don't get errors during the transition to lazy loading
 // if you have the new eager loaded recording code it will request this file, not `recorder.js`
 // so you don't have the problem that clients get new code and a cached recorder.js
diff --git a/packages/browser/src/entrypoints/recorder-v2.ts b/packages/browser/src/entrypoints/recorder-v2.ts
index d080f9e570..3e1fdc4f0c 100644
--- a/packages/browser/src/entrypoints/recorder-v2.ts
+++ b/packages/browser/src/entrypoints/recorder-v2.ts
@@ -1,2 +1,3 @@
-// This is only here for backwards compatibility
+// This file is kept only for backwards compatibility.
+// In almost every case, if you are manually importing a file you should use posthog-recorder instead.
 export * from './recorder'
diff --git a/packages/browser/src/entrypoints/recorder.ts b/packages/browser/src/entrypoints/recorder.ts
index 0ac68d0179..730a3f8468 100644
--- a/packages/browser/src/entrypoints/recorder.ts
+++ b/packages/browser/src/entrypoints/recorder.ts
@@ -1,3 +1,6 @@
+// This file is kept only for backwards compatibility.
+// In almost every case, if you are manually importing a file you should use posthog-recorder instead.
+
 import { record as rrwebRecord } from '@rrweb/record'
 import { getRecordConsolePlugin } from '@rrweb/rrweb-plugin-console-record'
 import { getRecordNetworkPlugin } from '../extensions/replay/external/network-plugin'