diff --git a/src/lib/elementary/efl_ui_box_stack.eo b/src/lib/elementary/efl_ui_box_stack.eo
index 61035b45f9..060f470f35 100644
--- a/src/lib/elementary/efl_ui_box_stack.eo
+++ b/src/lib/elementary/efl_ui_box_stack.eo
@@ -2,7 +2,10 @@ class @beta Efl.Ui.Box_Stack extends Efl.Ui.Box
 {
    [[A custom layout engine for @Efl.Ui.Box that stacks items.
 
-     Items will be stacked on top of each other (in the Z direction).
+     Items will be stacked on top of each other (in the Z direction) meaning that, in the absence of transparency,
+     only the last item added through the @Efl.Pack interface will actually be visible.
+
+     This can be useful to display transparent objects on top of each other, for example.
    ]]
    data: null;
    implements {