diff --git a/site/content/docs/02-template-syntax.md b/site/content/docs/02-template-syntax.md
index 1aa3bed6e4..a8007ec48e 100644
--- a/site/content/docs/02-template-syntax.md
+++ b/site/content/docs/02-template-syntax.md
@@ -694,6 +694,9 @@ However, the shorthand syntax cannot be used on this case.
 <div class:active,primary="{isActive}">...</div>
 ```
 
+> You should take care when using multiple `class` attributes, because it can affect each other. Like when using `class="foo" class:foo`, the second expression can remove the first one. Svelte warns when it finds the same name in multiple `class` expressions.
+
+
 #### use:*action*
 
 ```sv