diff --git a/packages/core/analytics/core-analytics-browser/README.md b/packages/core/analytics/core-analytics-browser/README.md
index 3d46f30137fb08..146e86b336d93b 100644
--- a/packages/core/analytics/core-analytics-browser/README.md
+++ b/packages/core/analytics/core-analytics-browser/README.md
@@ -1,3 +1,9 @@
 # @kbn/core-analytics-browser
 
 This package contains the public types for Core's browser-side analytics service.
+
+## Enabling debug logging
+
+Most events-related messages are logged under the `debug` level, which is silenced by default.
+
+Until per-context logging configuration is available, use `logging.browser.root.level: DEBUG` to enable debug logging.
\ No newline at end of file