Skip to content

docs: clarify Control layout behavior inside Containers #11664

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Arjun-explores-Arjun-learn wants to merge 4 commits into
base: master
Choose a base branch
from
+10 −0
Open

docs: clarify Control layout behavior inside Containers #11664

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
10da9be
docs: clarify Control layout behavior inside Containers
Arjun-explores-Arjun-learn Jan 23, 2026
d5da201
Update tutorials/ui/gui_containers.rst
Arjun-explores-Arjun-learn Jan 23, 2026
43d02ee
Update tutorials/ui/gui_containers.rst
Arjun-explores-Arjun-learn Jan 23, 2026
b83121f
Update tutorials/ui/gui_containers.rst
Arjun-explores-Arjun-learn Jan 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions tutorials/ui/gui_containers.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,14 @@ For that, :ref:`Containers <class_container>` are more useful.

Container layout
----------------
Controls inside Containers
Comment thread
Arjun-explores-Arjun-learn marked this conversation as resolved.
~~~~~~~~~~~~~~~~~~~~~~~~~~
A Control node can be laid out either manually or by a Container, depending on its context.
Comment thread
Arjun-explores-Arjun-learn marked this conversation as resolved.
When a Control node is not inside a Container, its position and size are controlled using anchors, offsets, and layout presets.
When a Control node is a direct child of a Container, the Container automatically manages its layout.
In this case, manual positioning options such as anchors and presets no longer affect the Control, as the Container enforces its own layout rules.
This behavior is expected. Containers are designed to ensure consistent and predictable layout of their children. To influence layout inside Containers,
use size flags, minimum size, and the rules specific to the Container type being used.
Comment thread
Arjun-explores-Arjun-learn marked this conversation as resolved.
Outdated

Containers provide a huge amount of layout power (as an example, the Godot editor user interface is entirely done using them):

Expand Down