Skip to content

docs: clarify Control layout behavior inside Containers#11664

Open
Arjun-explores-Arjun-learn wants to merge 4 commits into
godotengine:masterfrom
Arjun-explores-Arjun-learn:doc-control-layout-behavior
Open

docs: clarify Control layout behavior inside Containers#11664
Arjun-explores-Arjun-learn wants to merge 4 commits into
godotengine:masterfrom
Arjun-explores-Arjun-learn:doc-control-layout-behavior

Conversation

@Arjun-explores-Arjun-learn
Copy link
Copy Markdown

@Arjun-explores-Arjun-learn Arjun-explores-Arjun-learn commented Jan 23, 2026

This PR documents the user-visible layout behavior of Control nodes when they are used inside Containers.

When a Control is not inside a Container, it can be positioned manually using anchors, offsets, and presets. However, when a Control is a direct child of a Container, those manual options no longer affect it, and the Container takes over the layout.

This change adds a brief explanation to the online manual to clarify this behavior for users, without exposing internal properties or implementation details.

This PR addresses the user confusion discussed in godotengine/godot#108179 by documenting the observable layout behavior of Controls inside Containers.

Comment thread tutorials/ui/gui_containers.rst
Comment thread tutorials/ui/gui_containers.rst
Comment thread tutorials/ui/gui_containers.rst Outdated
@Calinou Calinou added enhancement area:manual Issues and PRs related to the Manual/Tutorials section of the documentation topic:gui labels Jan 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:manual Issues and PRs related to the Manual/Tutorials section of the documentation enhancement topic:gui

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants