FlowContainer in Godot – Complete Guide

Welcome to our tutorial on the FlowContainer class in Godot 4, an essential building block for creating dynamic and adaptable UI layouts in your game development projects. As you dive into the world of game creation, understanding how to manage and arrange your game’s interface can make a significant difference in both development time and user experience. Through this guide, we’ll explore the functionalities and benefits of the FlowContainer class, providing you with the knowledge necessary to produce engaging and responsive designs. So, if you’re looking to accelerate your game UI development skills, let’s get started on this rewarding journey!

What is FlowContainer?

A FlowContainer is a type of Container node in Godot’s robust engine, pivotal for UI development. It automates the arrangement of child controls — akin to letters forming words that wrap to a new line in a text block — either horizontally or vertically.

What is it Used For?

FlowContainers are instrumental when creating interfaces that demand flexibility. For example, when adding multiple buttons or elements, this container smartly wraps them to the next row or column, maximizing screen real estate and maintaining a clean aesthetic. They shine in scenarios with dynamic content, such as inventory systems or dynamic menus, ensuring a scalable layout that adjusts to various screen sizes and orientations.

Why Should I Learn About FlowContainer?

Mastering FlowContainer can convey numerous advantages:

– Improve UI responsiveness: Implement interfaces that adapt to various display sizes, enhancing user immersion.
– Manage content dynamically: Efficiently handle content that changes during gameplay, like inventory items.
– Streamline development: Focus on creative aspects rather than manually positioning each UI element, saving precious development time.

Understanding FlowContainers opens up a world of possibilities for UI design in Godot, and this mastery is just a few steps away. Let’s tackle them together!

CTA Small Image

Creating a Basic FlowContainer

To get started with a FlowContainer in Godot, let’s create a basic example where we add several buttons that flow naturally within the container.

extends Control

func _ready():
    var flow_container = FlowContainer.new()
    flow_container.rect_min_size = Vector2(400, 300)
    for i in range(10):
        var button = Button.new()
        button.text = "Button %d" % i

In this code, we:

– Create a FlowContainer instance and set its minimum size.
– Add the FlowContainer to the scene as a child of the Control node.
– Use a loop to create ten Button instances, each with a unique label.
– Add each Button to the FlowContainer, which automatically arranges them.

Adjusting Flow Direction

The FlowContainer class allows you to specify the direction in which elements flow. You can switch between horizontal and vertical flow with the `vertical` property.

flow_container.vertical = true  // Elements flow vertically
flow_container.vertical = false // Elements flow horizontally (default)

Here we switch the flow direction to vertical, which would stack the buttons on top of one another instead of lining them up side by side.

Handling Overflow with Wrapping

By default, if there isn’t enough space to display all elements in one line or column, FlowContainer will wrap them to the next line or column. You can adjust this behavior with the `wrap` property.

flow_container.wrap = true  // Enable wrapping (default)
flow_container.wrap = false // Disable wrapping

By setting `wrap` to false, all elements would try to fit on a single row or column, which might not be ideal for all UI designs.

Managing Element Separation

To space out the elements in a FlowContainer, we can use the `h_separation` and `v_separation` properties for horizontal and vertical spacing, respectively.

flow_container.h_separation = 10 // Horizontal spacing between elements
flow_container.v_separation = 20 // Vertical spacing between elements

Through these properties, you can fine-tune the spacing to best suit the visual design of your UI.

Aligning Children Within the FlowContainer

Suppose you want the children to align at the beginning, center, or end of the container when the total size of the children does not exceed the container’s size. You can use the `alignment` property.

flow_container.alignment = FlowContainer.ALIGN_BEGIN
flow_container.alignment = FlowContainer.ALIGN_CENTER
flow_container.alignment = FlowContainer.ALIGN_END

Each value of the `alignment` property adjusts the positioning of elements across the axis opposite to the flow’s direction, helping you refine the overall layout.As you become more familiar with the FlowContainer, you’ll appreciate the power and flexibility it brings to your UI design in Godot. Here, we’ll explore additional code examples that demonstrate some of the advanced capabilities available to you.

Adapting to Minimum Size Changes

UI elements often change size, such as when a button’s text length changes. The FlowContainer can automatically accommodate these changes.

var button = flow_container.get_child(0)
button.text = "A Longer Button Text"

Here, we’ve changed the text of the first button to something longer, and the FlowContainer will reflow the child elements accordingly.

If you want to ensure that elements maintain a consistent minimum size regardless of their content, you can set a size override.

button.rect_min_size = Vector2(150, 50)

The button will now maintain a minimum width of 150 pixels and a height of 50 pixels, even if its text would normally result in a smaller size.

Adding and Removing Elements Dynamically

FlowContainers are particularly useful when you need to add or remove elements on the fly during gameplay.

# To add a new button at runtime
var new_button = Button.new()
new_button.text = "New Button"

# To remove a button at runtime
var last_button = flow_container.get_child(flow_container.get_child_count() - 1)

In this snippet, you see how to add a new button and how to remove the last button added to the FlowContainer.

Customizing Child Elements

Sometimes your UI design calls for more than just placing elements in a container. You might wish to customize particular children within the container.

# Customizing every other button's style
for i in range(flow_container.get_child_count()):
    var button = flow_container.get_child(i)
    if i % 2 == 0: # If the index is even
        button.add_stylebox_override("Normal", preload("res://styles/AlternateButtonStyle.tres"))

The code snippet above demonstrates how to apply a custom style to every other button in the container, showcasing even rows or columns differentiation that could be an essential aspect of your game design.

Responding to Resize Events

As players may adjust the window size or play on different devices, your FlowContainer must respond to resize events.

func _on_resize():
    flow_container.rect_min_size = rect_size

This method could be connected to a resize signal, ensuring that the FlowContainer’s minimum size adjusts to the Control node’s size, maintaining the fluidity of the UI.

Utilizing Minimum and Maximum Size

Controlling the minimum and maximum size of the FlowContainer is sometimes necessary for maintaining a particular design or functionality.

flow_container.rect_min_size = Vector2(400, 300)
flow_container.rect_max_size = Vector2(800, 600)

With these properties set, the FlowContainer will not shrink below 400×300 pixels and will not grow beyond 800×600 pixels, giving you precise control over its size boundaries.

Through these various examples and properties, we can see the true versatility of the FlowContainer in Godot. By mastering its use, you’ll be well-equipped to design UIs that are both beautiful and functional, able to handle the dynamic nature of modern games with ease. Remember to experiment with different settings and properties to find the best results for your particular game’s UI.FlowContainer shines when dealing with UI elements of varying sizes. The following examples will help you handle varying content sizes and give you better control over your UI’s behavior.

Responsive UI with FlowContainer

To create a responsive UI, you can make a FlowContainer adapt to its parent size changes. Here’s how you can make it fill the entire parent.

func _ready():
    flow_container.rect_min_size = get_parent().rect_min_size
    flow_container.size_flags_horizontal = Control.SIZE_EXPAND_FILL
    flow_container.size_flags_vertical = Control.SIZE_EXPAND_FILL

This connects the FlowContainer’s size with its parent, making the FlowContainer expand or shrink with the parent Control node.

Incorporating Margin and Padding

You can fine-tune the look of your UI by setting margins for the FlowContainer, so that there’s space around its edges.

flow_container.margin_left = 10
flow_container.margin_top = 10
flow_container.margin_right = 10
flow_container.margin_bottom = 10

Setting margins ensures that your UI elements won’t stick to the FlowContainer’s edges, creating a more visually pleasing layout.

Handling Large Amount of Dynamic Content

When working with a large number of dynamic elements (like a grid of inventory items), you’ll want to add and remove them without performance hitches.

# To add multiple buttons in an optimized way
flow_container.queue_sort() # Disable automatic sorting

for i in range(100):
    var button = Button.new()
    button.text = str(i)

flow_container.queue_sort() # Enable and perform sorting once after all children are added

This code shows how you can efficiently add a large number of children to the FlowContainer by temporarily disabling automatic sorting, which avoids the container readjusting after each new child is added.

Scrolling through FlowContainer Elements

If you want to have more elements than what fits in the visible area of the FlowContainer, you can embed it in a ScrollContainer.

var scroll_container = ScrollContainer.new()
scroll_container.rect_min_size = Vector2(400, 600)
flow_container.rect_min_size = Vector2(400, 1200) # Larger than the ScrollContainer to allow scrolling

This example wraps the FlowContainer with a ScrollContainer. It ensures that even if the FlowContainer grows beyond the visible area, users will be able to scroll through its content.

It’s important to adjust the `rect_min_size` of the FlowContainer to account for the size you wish to be scrollable. This way, the ScrollContainer knows when to provide scrollbars to the user.

Changing Alignment Based on Content

Depending on the content, you might want to align your FlowContainer’s children differently. You can set the alignment programmatically, adjusting it at runtime based on specific conditions.

# A function to align elements based on a condition
func align_elements(condition):
    if condition:
        flow_container.alignment = FlowContainer.ALIGN_END
        flow_container.alignment = FlowContainer.ALIGN_BEGIN

You can call `align_elements(true)` or `align_elements(false)` to change the alignment dynamically, such as after a user action or event in the game.

Through detailed code examples, you’ve seen how to leverage the capabilities of the FlowContainer for responsive and dynamic UI designs in Godot. With just a bit of code, you can automate complex UI layouts that respond to your game’s needs, allowing you to focus on other aspects of game development. Keep experimenting and applying these concepts to unlock the full potential of the FlowContainer in your projects!

Where to Go Next with Godot Development

The adventure in game development is ongoing, and there’s always more to learn and create. If you’ve enjoyed exploring the capabilities of the FlowContainer in Godot and are eager to continue on your learning path, we have just the right resources for you.

Our Godot Game Development Mini-Degree is an extensive collection of courses tailored to help you build cross-platform games from the ground up using the Godot 4 engine. Whether you’re new to coding or an experienced developer, our curriculum takes you through a range of relevant topics, from the basic principles to more complex game development concepts. Learn at your own pace and access our courses on any device.

Looking for a more expansive dive into what Godot has to offer? Our range of Godot courses encompasses a broad spectrum of subjects within the engine, equipping you with the tools needed to create the games you envision.

Embrace the opportunity to expand your knowledge and skills with Zenva. Your journey in game development awaits—with us, you can go from beginner to professional, all while creating games you’re passionate about.


The FlowContainer in Godot 4 is a powerful ally in any developer’s toolkit, and mastering its potential is just the beginning of what you can achieve in game development. We hope that the knowledge you’ve gained here sparks even more creativity and efficiency in your UI design endeavors. Remember, the best way to consolidate learning is by applying it, so dive into your projects and let the FlowContainer streamline your game’s interface.

Are you feeling inspired to take your Godot skills to the next level? Explore our Godot Game Development Mini-Degree for in-depth tutorials, real-world projects, and the guidance you need to become a proficient game developer. Together, let’s turn your ideas into fully-fledged, playable realities. With Zenva, you’re on the path to game development mastery!

Python Blog Image

FINAL DAYS: Unlock coding courses in Unity, Godot, Unreal, Python and more.