diff --git a/docs/BUGS.md b/docs/BUGS.md
new file mode 100644
index 0000000..04d7a1b
--- /dev/null
+++ b/docs/BUGS.md
@@ -0,0 +1,7 @@
+# Bugs
+
+## Reports from the extension audit
+
+### Portal online block disappears with the extension enabled
+
+The listener disables the core online-list flag and provides its own. Verify companion portal integration and preserve the standard board display. [Source](https://www.phpbb.com/customise/db/extension/separate_users_and_bots/support/topic/250057)