diff --git a/docs/guides/commands/commands.md b/docs/guides/commands/commands.md
index bbec81788..b02cd62a5 100644
--- a/docs/guides/commands/commands.md
+++ b/docs/guides/commands/commands.md
@@ -345,4 +345,8 @@ and must be explicitly added.
 
 To install a TypeReader, invoke [CommandService.AddTypeReader].
 
+> [!WARNING]
+> TypeReaders must be added prior to module discovery, otherwise your
+> TypeReaders may not work!
+
 [CommandService.AddTypeReader]: xref:Discord.Commands.CommandService.AddTypeReader*