CenterContainer in Godot – Complete Guide

Understanding the power of Godot’s CenterContainer can significantly elevate your game designs, whether you’re crafting dynamic menus, ensuring in-game UI elements maintain an aesthetic appeal, or simply streamlining your workflow for a more efficient design process. Let’s unlock the potential of the CenterContainer and learn how to maintain polished, centered UI elements regardless of screen size or aspect ratio, a common challenge for game developers.

What Is CenterContainer?

The CenterContainer class in Godot is a specialized container node designed to automatically center its child nodes. It does this by adjusting the child nodes to their minimum size and positioning them in the middle of the container. This behavior is particularly useful in UI design where elements such as buttons, labels, and panels need to be in the center regardless of screen dimensions or changes in the layout.

What Is It For?

The primary purpose of the CenterContainer is to ensure that UI components are always positioned in the center, which not only makes your interfaces look more professional but also enhances user experience. It’s a go-to node when you are designing menus or any interface elements that require a central focal point. Think of a pause menu or a pop-up dialog in the middle of the screen; these are perfect candidates for CenterContainer usage.

Why Should You Learn It?

In game development, understanding the various UI components and how they interact is key to creating smooth and user-friendly experiences. Learning how to use the CenterContainer effectively can make a significant difference in your ability to produce clean, adaptive UIs. This skill is valuable for ensuring your games feel polished and function well across multiple device resolutions. Plus, mastering this aspect of Godot can streamline your UI development process, freeing up more time to focus on other critical areas of game creation.

CTA Small Image

Getting Started with CenterContainer in Godot

First, let’s begin with the basic setup for using CenterContainer. You’ll typically start by adding a CenterContainer node to your scene. Here’s the step-by-step process and the corresponding script to get it initialized.

var center_container =

Once you’ve created and added the CenterContainer to your scene, you can begin adding child nodes to it. Remember, these children will be automatically centered within the container.

var my_label =
my_label.text = "Hello, I'm centered!"

Centering UI Elements

Centering UI elements is the primary function of the CenterContainer node. Let’s add a TextureRect to display an image in the center of the screen. You would create the TextureRect and ensure it’s a child of the CenterContainer:

var texture_rect =
texture_rect.texture = preload("res://path_to_your_image.png")

And if you want to center a button, it’s just as straightforward. Here’s how you would do it:

var my_button =
my_button.text = "Click Me"

If we want to make sure this setup is responsive and maintains the centered position even when the window size changes, we need to attach the CenterContainer to a control node that fills the screen, such as a Panel or a MarginContainer:

var full_panel =
var center_container =
center_container.rect_min_size = Vector2(100, 100) # Ensuring container is visible
full_panel.rect_min_size = get_viewport_rect().size # Make Panel fill the viewport

Customizing the CenterContainer

The CenterContainer can be customized to better fit the design of your game. For example, you may decide to adjust the margins around the centered elements. This can be done by modifying the ‘custom_constants/margin’ property of the CenterContainer. Here’s how:

center_container.set("custom_constants/margin_top", 20)
center_container.set("custom_constants/margin_bottom", 20)
center_container.set("custom_constants/margin_left", 10)
center_container.set("custom_constants/margin_right", 10)

It may also be necessary to use the CenterContainer with other UI components in Godot’s sophisticated layout system. The following combines a VBoxContainer with our CenterContainer to stack several elements vertically in the center:

var vbox =
var label_one =
label_one.text = "First Label"
var label_two =
label_two.text = "Second Label"


With these examples, you’ve now seen how to create a CenterContainer, add different UI elements to it, adjust its properties for customization, and even how to nest it with other containers for more complex UI structures. Remember to apply these examples in context, tweaking sizes and properties to match the needs of your specific game project.

To further explore the CenterContainer’s capabilities, let’s delve into some common scenarios where this node plays a crucial role. We’ll illustrate these with code examples.

Imagine we want to create a simple main menu. We might want a title, a couple of buttons aligned vertically, and all of these centered on the screen. Here’s how you could achieve this:

var center_container =
var vbox =

var title =
title.text = "Main Menu"

var start_button =
start_button.text = "Start Game"

var options_button =
options_button.text = "Options"


Now, if you wanted to apply a thematic style to your UI components that are placed within the CenterContainer, you might set a Theme resource that adjusts fonts, colors, and other styles:

var custom_theme = preload("res://path_to_your_theme.tres")
center_container.theme = custom_theme

Let’s consider loading screens. We often want to display a loading bar that’s centered, potentially with text indicating loading progress above or below the bar. Here is how you can set this up:

var center_container =
var vbox =

var loading_label =
loading_label.text = "Loading..."

var progress_bar =
progress_bar.value = 50  # assuming 50% loaded for demonstration


For scenarios where you want a pop-up centered on the screen, like an error message or notification, the CenterContainer can also be used within a Popup node. Here’s a basic example:

var popup =
var center_container =
var error_label =
error_label.text = "An error occurred!"


popup.popup_centered(Vector2(200, 100))  # Opens the popup with the specified size

If you’re creating an inventory screen with a centered grid of items, a GridContainer inside a CenterContainer can help maintain that central alignment:

var center_container =
var grid =
grid.columns = 4

# Populate the grid with example items
for i in range(8):  # Assuming we have 8 items for demonstration
    var item_texture =


The CenterContainer can even work in conjunction with animations. For instance, you could animate its children appearing one after another using AnimationPlayer. This is an example of setting up a simple animation for a label to fade in:

var animation_player =
var label =
label.text = "I will fade in!"
label.opacity = 0  # Start fully transparent

var animation =
animation.length = 1.0  # The animation lasts for 1 second
animation.tracks[0].type = Animation.TYPE_VALUE
animation.tracks[0].path = NodePath(label.get_path() + ":opacity")
animation.tracks[0].keys = {
    0.0: {"value": 0.0},
    1.0: {"value": 1.0}

animation_player.add_animation("fade_in", animation)

As you can see, Godot’s CenterContainer is versatile and can be applied to a variety of UI layouts and designs. Whether you’re working on menus, loading screens, pop-ups, or animated elements, mastering the CenterContainer allows you to create clean, centered UIs that adjust perfectly to different screen sizes and aspect ratios.

At Zenva, we’re committed to providing high-quality tutorials that empower you to shape your own coding and game development journey. The examples shared here are simplified to focus on specific uses of CenterContainer, and we encourage you to explore its full potential by incorporating it into more complex projects. Discover how to design adaptable and polished interfaces that enhance the player experience in all your games!

Let’s delve into a few more practical uses of the CenterContainer node with examples, which will provide a deeper understanding of how to integrate it into your Godot projects.

Sometimes you might want to display a centered message with an icon, such as a warning or information icon next to a label. You can use an HBoxContainer inside a CenterContainer for this:

var center_container =
var hbox =

var icon_texture =
icon_texture.texture = preload("res://path_to_your_icon.png")

var message_label =
message_label.text = "Warning: Low Battery"


When creating a table-like layout where you need columns of data centered on the screen, you can nest multiple VBoxContainers within an HBoxContainer, which is then placed inside a CenterContainer:

var center_container =
var hbox =

# Creating three columns
for i in range(3):
    var vbox =
    for j in range(5):  # Adding 5 labels to each column
        var label =
        label.text = "Row " + str(j) + ", Col " + str(i)


An interesting use-case for the CenterContainer is when you’re implementing a custom designed slider, such as a volume control in the options menu. Here’s how you might set this up:

var center_container =
var slider =
slider.min_value = 0
slider.max_value = 100
slider.step = 1
slider.value = 50  # Default value set to 50%

var volume_label =
volume_label.text = "Volume"


For a card-based game, you may want to display a centered hand of cards. You could use a CenterContainer with an HBoxContainer as its child to maintain a centered alignment while allowing for horizontal distribution:

var center_container =
var hbox =

# Assume you have a Card class that extends TextureRect or similar.
# Here we instantiate and add a few card instances to our hbox.
for i in range(5):  # Number of cards
    var card =


Lastly, in a fighting game where you want to display a health bar that remains centered in the view, the CenterContainer is perfect to ensure its position stays consistent, regardless of the screen size:

var center_container =
var health_bar =
health_bar.value = 80  # Assuming the player starts with 80% health


While these examples are relatively straightforward, they illustrate the flexibility of the CenterContainer node. By incorporating CenterContainer into different structural layouts, you can achieve neatly arranged and adaptive UI elements with minimal effort. Experimenting with nested containers like VBoxContainer and HBoxContainer within a CenterContainer can lead to a wide range of designs that are both visually appealing and functionally robust.

At Zenva, we’re passionate about guiding learners through their journey in game development with accessible and informative content. We embrace the philosophy that clear, hands-on examples pave the way to a deeper understanding of game development principles. Embrace the power of the CenterContainer in your next Godot project and create user interfaces that truly stand out!

Continue Your Godot Development Journey

With the knowledge you’ve gained about Godot’s CenterContainer, you’re well on your way to designing immersive and professional user interfaces in your game projects. The beautiful thing about learning game development is that there’s always more to discover and master. If you’re eager to dive deeper and expand your Godot expertise, our Godot Game Development Mini-Degree is an excellent next step.

This comprehensive collection of courses is perfect for both novices and seasoned developers looking to sharpen their skills. You’ll explore the vast capabilities of the Godot engine through hands-on projects and interactive lessons. Each course is designed to be flexible, allowing you to learn at your own pace and on your own schedule. Plus, upon completing your projects, you’ll earn certificates that can shine on your resume or portfolio.

For those who seek a broader range of topics and want to explore all that Godot has to offer, take a look at our full list of Godot courses. Zenva provides a learning path for everyone, from beginner to professional, to learn coding, create games, and boost your career. Join us in this adventure and turn your game development dreams into reality!


Mastering the CenterContainer in Godot marks a crucial milestone in your journey as a game developer. With the power to centralize UI elements with ease, you’re unlocking the potential for sleek, responsive, and user-friendly interfaces. This knowledge not only enhances the visual appeal of your games but also contributes to a smoother player experience. Let your creativity flow and witness your games transform with the magic of Godot’s CenterContainer.

We at Zenva believe in nurturing your passion for game development by providing you with the resources and guidance you need to excel. Our Godot Game Development Mini-Degree is tailored to help you build a solid foundation and progressively tackle more complex projects. So, continue your adventure with us, refine your skills, and become part of a community of developers crafting the future of gaming. Start today and create the games you’ve always dreamt of!

Python Blog Image

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