diff --git a/docs/paper/admin/reference/configuration/bukkit-commands-configuration.mdx b/docs/paper/admin/reference/configuration/bukkit-commands-configuration.mdx
index 9a44e57c4..77d10b924 100644
--- a/docs/paper/admin/reference/configuration/bukkit-commands-configuration.mdx
+++ b/docs/paper/admin/reference/configuration/bukkit-commands-configuration.mdx
@@ -15,6 +15,16 @@ Click on a leaf node to view the description for that setting.
 
 :::
 
+:::warning
+
+The aliases defined in this legacy file do not support modern features
+- Tab completion
+- Permissions
+
+For these, see `config/command-aliases.yml` (Pending PR merge) {/*[`config/command-aliases.yml`](docs/paper/admin/reference/configuration/command-aliases.mdx)*/}. {/* TODO create other docs page */}
+
+:::
+
 <Config data={`
 command-block-overrides:
   default: '[<command to override>]'