diff --git a/doc/classes/ViewportContainer.xml b/doc/classes/ViewportContainer.xml
index 35fc18346e2..83bfea54211 100644
--- a/doc/classes/ViewportContainer.xml
+++ b/doc/classes/ViewportContainer.xml
@@ -5,6 +5,7 @@
 	</brief_description>
 	<description>
 		A [Container] node that holds a [Viewport], automatically setting its size.
+		[b]Note:[/b] Changing a ViewportContainer's [member Control.rect_scale] will cause its contents to appear distorted. To change its visual size without causing distortion, adjust the node's margins instead (if it's not already in a container).
 	</description>
 	<tutorials>
 	</tutorials>