Panel in Godot – Complete Guide

Welcome to this tutorial where we’ll dive into the world of Godot 4 and one of its fundamental GUI elements: the Panel class. If you’ve been exploring the realms of game development, especially through Godot’s thriving open-source environment, mastering the Panel class is a vital step in creating engaging and user-friendly graphical user interfaces (GUIs) for your games. Stick with us to unravel how Panel functions, its practical applications, and why it’s a skill you’ll want to have in your game development toolkit.

What Is Panel?

The Panel class in Godot 4 plays a key role in GUI design. It’s designed to act as a canvas-like component that displays a styleable box, otherwise known as a StyleBox.

What Is It For?

Panels are often used as building blocks for more complex GUI elements. They can serve as backgrounds for text, buttons, or any interactive element in a game’s interface which enhances the visual experience for players.

Why Should I Learn It?

Learning how to use the Panel class effectively can elevate your game design, offering:

  • Customization: Tailor the look and feel of your game’s UI according to your creative vision.
  • Organization: Segment different parts of your interface for better user navigation.
  • Efficiency: Use Godot’s theming system to quickly update and manage your UI’s aesthetics.

Whether you’re eager to polish your existing project or start a new one with a solid foundation, understanding the Panel class is essential. So, let’s get started!

CTA Small Image

Creating a Basic Panel

To begin, let’s create a simple panel in Godot. This will serve as the foundation for many of your interface elements.

var panel =

In the above example, we first create a new Panel instance and then add it as a child to the current node, which will likely be a control node that manages your user interface.

Setting Up Panel Properties

Next, we can set up the panel’s properties, such as its size and position within the game window.

panel.rect_min_size = Vector2(300, 200)
panel.rect_position = Vector2(50, 100)

These lines of code configure the panel’s minimum size and position its top-left corner 50 pixels from the left and 100 pixels from the top of the game window.

Styling a Panel with Themes

Styling is key to a visually appealing UI. Here’s how you can apply a theme to your panel:

var theme =
var stylebox =
stylebox.texture = preload("res://path_to_your_texture.png")
theme.set_stylebox("panel", "Panel", stylebox)
panel.theme = theme

This code snippet accomplishes several things: It creates a new theme, makes a new StyleBoxTexture, preloads a texture for the style box, and then sets that stylebox as the theme for the ‘panel’ node under the ‘Panel’ type. Finally, we apply the theme to our panel.

Adding GUI Elements to the Panel

The true power of panels is revealed when they’re used as containers for other GUI elements. Here’s how to add a button to our panel:

var button =
button.text = "Click Me!"

This snippet creates a new Button node, sets its text, and then adds it as a child of the panel, which means it will be displayed within the panel’s bounds.

Responding to User Interactions

Interactivity is crucial in game UI. This is how you can connect a button’s pressed signal to a function:

button.connect("pressed", self, "_on_Button_pressed")

func _on_Button_pressed():
    print("Button was pressed!")

These lines of code connect the button’s “pressed” signal to a function in the current script (`_on_Button_pressed`). Whenever the button is pressed, “Button was pressed!” will be printed to the output.

Using Panels for Organization

Lastly, let’s use panels to organize multiple elements in a form-like structure, which can be useful for settings menus or inventory screens:

var label =
label.text = "Username:"

var line_edit =

label.rect_min_size = Vector2(100, 20)
label.rect_position = Vector2(10, 10)
line_edit.rect_min_size = Vector2(190, 30)
line_edit.rect_position = Vector2(110, 5)

Here, we’ve added a Label and LineEdit as children to the panel. We then set their sizes and positions to create a simple form field for a username.

Each of these code snippets presents the basic functionality of the Panel class in Godot 4. Experimenting with these examples in your own projects will greatly enhance your familiarity with Godot’s UI system and prepare you for more advanced concepts.Panels can be extremely versatile in Godot. Not only can they function as simple backdrops, but they can also be the groundwork for the more complex parts of your UI, like navigation bars, window frames, or custom-shaped buttons. Using them effectively can create a user interface that’s both beautiful and intuitive.

Let’s take a look at some more ways in which you can manipulate panels and make your interfaces stand out.

Creating a Navigation Bar

Imagine you want to create a navigation bar at the top of your game window. You can use a panel for the bar and then add buttons on it for the different navigation options.

var nav_panel =
nav_panel.rect_min_size = Vector2(1024, 50)

var home_button =
home_button.text = "Home"
home_button.rect_min_size = Vector2(100, 40)

var settings_button =
settings_button.text = "Settings"
settings_button.rect_min_size = Vector2(100, 40)
settings_button.rect_position = Vector2(100, 0)

Here, we’ve created a navigation panel and two buttons. We’ve also positioned the settings button next to the home button by manipulating its position.

Window Panel with Close Functionality

Perhaps you need a window panel for a settings menu that can be closed. Below is a way to implement a panel with a close button.

var window_panel =
window_panel.rect_min_size = Vector2(400, 300)

var close_button =
close_button.text = "X"
close_button.rect_min_size = Vector2(20, 20)
close_button.rect_position = Vector2(window_panel.rect_min_size.x - 30, 10)

close_button.connect("pressed", self, "_on_CloseButton_pressed")

func _on_CloseButton_pressed():

The above snippet shows how to create a window panel and a close button, which when pressed, removes the window from the scene entirely.

Custom-shaped Button

Panels can also be used as foundations for custom-shaped buttons. You can load a texture with a unique shape and apply it to the panel, then use it as a clickable area.

var custom_button_panel =
var custom_stylebox =
custom_stylebox.texture = preload("res://custom_shape.png")
custom_button_panel.add_stylebox_override("panel", custom_stylebox)

custom_button_panel.connect("gui_input", self, "_on_CustomButtonPanel_gui_input")

func _on_CustomButtonPanel_gui_input(event):
    if event is InputEventMouseButton and event.pressed:
        print("Custom button clicked!")

This code creates a panel, applies a custom-shaped texture as a stylebox, and then responds to mouse input to simulate button-like behavior.

Animated Health Bar with Panel

Panels can also be used to create HUD elements like health bars. Here’s how you can set up and animate a health bar using the Panel class:

var health_bar_panel =
var health_bar_back =
health_bar_back.texture = preload("res://health_bar_back.png")
var health_bar_front =
health_bar_front.texture = preload("res://health_bar_front.png")


# Here's how you can animate the health bar when taking damage
func reduce_health(amount: float):
    var new_width = max(health_bar_front.rect_min_size.x - amount, 0)
    health_bar_front.rect_min_size.x = new_width

Using a Panel as a container, the health bar is composed of a background (health_bar_back) and a foreground (health_bar_front) that reduces in width to signify damage.

Each one of these examples demonstrates the different ways panels can be utilized beyond their basic functions. Understanding and leveraging the full potential of the Panel class allows you to create a more polished and dynamic experience for your players, making your game stand out. Now, take what we’ve learned here and start experimenting with panels in your own Godot projects. Happy coding!Continuing with our exploration of the versatile Panel class in Godot, let’s examine more advanced applications that can really spice up your UI design. As we delve into these more complex setups, you’ll see how integrating panels can add depth and functionality to your user interfaces.

Tooltip System Using Panels

A common feature in games, tooltips can provide helpful information when the player hovers over an item. Let’s see how we can implement a simple tooltip system.

var tooltip_panel =
tooltip_panel.visible = false
var tooltip_label =

func _on_MouseHovered():
    tooltip_panel.rect_global_position = get_global_mouse_position() + Vector2(10, 10)
    tooltip_label.text = "Useful Tooltip Text"
    tooltip_panel.visible = true

func _on_MouseExited():
    tooltip_panel.visible = false

# Connect the hover and exit signals from your UI elements to these two functions

Here, we create a panel that becomes visible and shows a label with tooltip text whenever the mouse hovers over a UI element. The tooltip follows the mouse cursor, providing immediate feedback.

Dialogue Box with Typewriter Effect

Creating an engaging dialogue box complete with a typewriter effect can really draw players into your game’s narrative. Here’s a quick setup for that:

var dialogue_panel =
dialogue_panel.rect_min_size = Vector2(800, 100)
var dialogue_label =

var dialogue_text = "This is example dialogue that will appear one letter at a time."
var dialogue_index = 0

func _process(delta):
    if dialogue_index < dialogue_text.length():
        dialogue_label.text += dialogue_text[dialogue_index]
        dialogue_index += 1
        yield(get_tree().create_timer(0.05), "timeout")

This piece of code slowly builds up text within a label child of the dialogue panel, mimicking the classic typewriter effect often seen in RPG dialogues.

Scrollable Content Area

Not all content fits within the confines of a small panel. A scrollable content area allows extensive content to be accessible within a fixed space.

var scroll_container =
scroll_container.rect_min_size = Vector2(400, 300)
var content_panel =
content_panel.rect_min_size = Vector2(400, 1000) # Content is larger than container

# Add your content to content_panel

In the code above, a ScrollContainer, which contains a content panel larger than itself, creates a scrollable area. Players can scroll to view the entire content within the allotted space.

Inventory Grid with Panels

An inventory system is another common feature in games. You might want a grid-like structure to display items as icons.

var inventory_panel =
inventory_panel.rect_min_size = Vector2(400, 400)

var item_icon_scene = preload("res://path_to_item_icon_scene.tscn")

# Assuming we have an array with inventory items
var inventory_items = [item1, item2, item3, ...] 

for i in range(inventory_items.size()):
    var item_icon = item_icon_scene.instance()
    var col = i % 4
    var row = i / 4
    item_icon.rect_position = Vector2(col * 100, row * 100)

This snippet populates an inventory panel with item icons, positioning each one on a grid based on their index in the inventory array.

Setting Panel Opacity

Sometimes, you might want your panel to have some degree of transparency, perhaps for a pause menu where you still want to see the game in the background.

var pause_menu_panel =
pause_menu_panel.modulate = Color(1, 1, 1, 0.5) # Set the alpha to 0.5 for half transparency

# Add pause menu elements to pause_menu_panel

The `modulate` property allows you to change the Panel’s color and transparency, in this case setting alpha to 0.5 to achieve a semi-transparent effect.

These are just a handful of ways the Panel class in Godot can be utilized to enhance your game’s UI. With these techniques, you can start creating more dynamic, engaging, and sophisticated interfaces that keep players absorbed in your game world. Panels are incredibly powerful – they can make a big difference in how players perceive and interact with your game, so take advantage of what they have to offer in your next project!

Continue Your Game Development Journey

Having learned about the incredible possibilities that the Panel class offers in Godot, you’re well on your way to mastering UI design in game development. But don’t stop here! To further hone your skills and continue your journey in becoming a proficient game developer, we have resources tailored just for you.

Our Godot Game Development Mini-Degree is a comprehensive collection designed to take you from the fundamentals to more complex game development concepts. You’ll learn to create cross-platform games using various features of the Godot engine, such as producing rich 2D and 3D games, scripting with GDScript, building engaging gameplay mechanics, and much more. This program is perfect for both beginners and those with some experience under their belts, offering a flexible learning path to accommodate your pace and schedule.

Beyond this, our broad selection of Godot courses covers different aspects and genres of game development, ensuring you can find just the right course to suit your interests and career goals.

At Zenva, we’re passionate about empowering you to take your skills to the next level. Dive into our courses, build your portfolio, and prepare for exciting opportunities in the ever-growing game development industry. Your next big game project is just a course away!


Now that you have a wealth of knowledge about the Panel class in Godot and how to leverage it for a polished game UI, you’re set to transform your game development ideas into playable realities. Remember, these fundamentals of UI design are just the beginning; with creativity and practice, you’re well on your way to making interfaces that are not only functional but also a joy to navigate. Embrace the art of game creation, where every panel you design is a step closer to crafting the immersive experiences that players crave.

We at Zenva encourage you to keep exploring, learning, and building. Whether you aim to create the next indie hit or simply want to bring your dream game to life, our Godot Game Development Mini-Degree is your launchpad. With each lesson, you’ll gain more tools for your developer toolkit, opening doors to new possibilities. Ready to take your game development to new heights? Join us, and let’s create unforgettable gaming moments together.

Python Blog Image

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