diff --git a/en/ui-system/components/editor/ui-opacity.md b/en/ui-system/components/editor/ui-opacity.md
index af59d62dc2..5d6a690c51 100644
--- a/en/ui-system/components/editor/ui-opacity.md
+++ b/en/ui-system/components/editor/ui-opacity.md
@@ -2,6 +2,8 @@
 
 The UIOpacity Component records a transparency modification flag for the node, which is used to influence all the render nodes inside its sub tree. Normally it's used on a non render nodes, otherwise its opacity will be multiplied with the render component's opacity. The render nodes can set transparency individually by setting the alpha channel of `color`.
 
+> **Note**: this component is only functional when its root node have Canvas component or RenderRoot2D component.
+
 The method of use is as follows:
 
 ![ui-opacity](uiopacity/ui-opacity.png)
diff --git a/zh/ui-system/components/editor/ui-opacity.md b/zh/ui-system/components/editor/ui-opacity.md
index c07d7afeb2..9c0c12e596 100644
--- a/zh/ui-system/components/editor/ui-opacity.md
+++ b/zh/ui-system/components/editor/ui-opacity.md
@@ -2,6 +2,8 @@
 
 该组件会为节点记录一个透明度修改标识用来影响到后续的渲染节点。一般用于非渲染节点，如果作用在渲染节点上会形成透明度叠加现象。渲染节点可以通过设置 color 的 alpha 通道来设置透明度。
 
+> **注意**：该组件仅对根节点上有 Canvas 或 RenderRoot2D 组件的节点生效。
+
 使用方法如下：
 
 ![ui-opacity](uiopacity/ui-opacity.png)