diff --git a/docs/src/main/asciidoc/config-reference.adoc b/docs/src/main/asciidoc/config-reference.adoc
index bfd359c43ae38..87111fa5e92f2 100644
--- a/docs/src/main/asciidoc/config-reference.adoc
+++ b/docs/src/main/asciidoc/config-reference.adoc
@@ -397,6 +397,9 @@ Properties in the profile aware file have priority over profile aware properties
 
 [WARNING]
 ====
+Do not use Profile aware files to set `quarkus.profile` or `quarkus.test.profile`. This will not work because the
+profile is required in advance to load the profile aware files.
+
 A profile aware file is only loaded if the unprofiled `application.properties` is also available in the same location
 and the file extension matches between the files. This is required to keep a consistent loading order and pair all the
 resources together.