Theme in Godot – Complete Guide

Creating visually appealing and cohesive interfaces is as essential in game development as crafting engaging gameplay mechanics. This is where themes come into play, especially within the Godot Engine—a popular choice for both beginner and veteran developers due to its open-source nature and powerful features. Themes in Godot provide a consistent and easily modifiable way to style controls and user interface elements, fostering a seamless user experience.

What Is a Theme in Godot?

A Theme in Godot is a resource that includes a collection of visual styles which can be applied to UI elements in your game. The Theme class allows you to create a unified look and feel across multiple control nodes, making it simpler to manage and update the UI design across your entire game.

What Is It For?

Imagine you’re creating a vast kingdom in a medieval fantasy game. You want all the dialog boxes, menus, and buttons to have a consistent style that evokes the game’s era. Instead of individually styling each element, you create a singular Theme that encompasses the desired styles, fonts, colors, and icons. Now you can apply this Theme across the entire game, ensuring that every element consistently reflects the medieval aesthetic.

Why Should You Learn About Themes?

Learning about Themes in Godot not only saves time and effort in the long run but also elevates the polish and professionalism of your game. By mastering Themes, you can easily experiment, iterate, and refine your game’s UI, which can greatly impact the overall player experience. Moreover, understanding how to manipulate Themes is a step forward in mastering UI/UX design principles within Godot 4, which is an invaluable skill set in the game development industry.

In the following sections, we’ll give you a hands-on approach to working with the Theme class, providing examples and insights that will help you fine-tune the aesthetic of your game projects effortlessly. Whether you’re a budding developer or an experienced coder looking to improve your UI design skills, the following tutorial will provide you with a solid foundation in using Themes effectively in your Godot projects.

CTA Small Image

Creating a Basic Theme

To start creating a Theme in Godot, we first need a Control node to which the Theme will be applied. For this tutorial, let’s assume you have a GUI scene with a Panel node serving as your main menu background.

var panel =

Next, we’ll create a new Theme resource. In the Godot editor, you can do this by selecting ‘New Resource’ in the Inspector and choosing ‘Theme’. Alternatively, here’s how you would create one via code:

var new_theme =
panel.theme = new_theme

With the Theme applied to the Panel, now we can set some basic styles. Let’s customize the background color of our Panel:

new_theme.set_color("bg_color", "Panel", Color(0.1, 0.1, 0.1))

Styling Button Nodes

Buttons are a staple in any UI toolkit; let’s style a few to match our new Theme. Assuming we have a button node in our scene:

var button =

We can start styling the buttons with our Theme by setting the proper styles for different states—normal, hovered, disabled, etc.:

new_theme.set_stylebox("normal", "Button",
new_theme.set_stylebox("hover", "Button",
new_theme.get_stylebox("hover", "Button").bg_color = Color(0.25, 0.25, 0.25)

This code sets the normal and hovered styles for our buttons. The hover state has a slightly lighter bg_color, making it noticeable when interacted with.

Customizing Fonts

Uniform text styles are central to maintaining cohesive aesthetics. Let’s define a custom font for our Theme:

var font =
font.font_data = load("res://path_to_your_font.tres")
font.size = 14
new_theme.set_font("font", "Button", font)

This loads a font resource and applies it to Button nodes within our Theme, ensuring all buttons share the same font style and size.

Utilizing Icons

Godot allows adding icons to your Theme, which can then be applied to any Control node. To add an icon, you can use the following snippet:

var icon = load("res://path_to_your_icon.png")
new_theme.set_icon("icon", "Button", icon)

After setting the icon, you can then access it from any Button in your UI:

button.icon = new_theme.get_icon("icon", "Button")

These code examples cover the basics of creating and applying a Theme in Godot. By understanding these fundamental principles, you can begin to explore more complex and nuanced styling to ensure your game’s UI is both functional and aesthetically pleasing.

In the next section, we will delve deeper into the practical applications of Themes with more examples and advanced techniques that can be used to create a truly dynamic and immersive UI experience for your game. Stay tuned!

When it comes to deepening our understanding of Themes in Godot, it’s vital we explore advanced customization options that can truly elevate your game’s user interface. Let’s say you want different types of buttons within your game—like primary buttons for main actions and secondary buttons for less important actions. Here’s how you can create those variations within a single Theme:

Creating a StyleBox for the primary button:

var primary_button_style =
primary_button_style.bg_color = Color(0.3, 0.4, 0.6)
new_theme.set_stylebox("normal", "Button", primary_button_style)

And another one for the secondary button:

var secondary_button_style =
secondary_button_style.bg_color = Color(0.2, 0.3, 0.4)
new_theme.set_stylebox("normal", "SecondaryButton", secondary_button_style)

We use a fictional “SecondaryButton” type which would be a custom class you’ve created inheriting from Button. Remember that you can extend the control nodes to create your custom types.

Next, let’s enhance the visual feedback of our buttons by customizing the “pressed” state:

var button_pressed_style =
button_pressed_style.bg_color = Color(0.2, 0.25, 0.3)
new_theme.set_stylebox("pressed", "Button", button_pressed_style)
new_theme.set_stylebox("pressed", "SecondaryButton", button_pressed_style)

This will give both button types a darker shade when they’re pressed, providing immediate visual feedback to the player.

Moving on to toggles and checkboxes which are other common UI elements, you might want them to fit the Theme. Here’s how you could style a CheckButton:

var checkbutton_normal_style =
checkbutton_normal_style.bg_color = Color(0.2, 0.3, 0.4)
new_theme.set_stylebox("normal", "CheckButton", checkbutton_normal_style)

var checkbutton_pressed_style =
checkbutton_pressed_style.bg_color = primary_button_style.bg_color
new_theme.set_stylebox("pressed", "CheckButton", checkbutton_pressed_style)

With a customized CheckButton, you ensure that even your checkboxes match the overall feel of your game’s UI.

Furthermore, sliders often find their place in game settings. Customizing their Theme maintains the visual consistency. Here’s how you might style the grabber of a HSlider (Horizontal Slider):

var slider_grabber_style =
slider_grabber_style.bg_color = Color(0.5, 0.5, 0.5)
new_theme.set_stylebox("grabber", "HSlider", slider_grabber_style)

This will make the grabber of your sliders stand out against the track, making it clearer for users to see and interact with.

Last but not least, Tooltips are an informative feature, guiding players about button functions or providing hints. Here’s a simple way to ensure they’re styled appropriately:

var tooltip_background =
tooltip_background.bg_color = Color(0, 0, 0, 0.7)
new_theme.set_stylebox("panel", "TooltipPanel", tooltip_background)

var tooltip_font =
tooltip_font.font_data = font.font_data
tooltip_font.size = 12
new_theme.set_font("font", "TooltipLabel", tooltip_font)

By setting a semi-transparent background and a slightly smaller font size, you create a distinct style for your tooltips that is still cohesive with the rest of the UI.

Through the above examples, we’ve seen a range of possibilities for customizing different UI elements using a Theme in Godot. The concept is extendable to virtually any Control node, making Themes a powerful tool for developers looking to fine-tune the look and feel of their game’s interface. With practice and exploration, you’ll be able to create more intricate and specialized Themes that align with the specific aesthetic needs of your projects.

Embellishing your Theme with additional layers of customization can distinguish your game’s UI and create a memorable experience for players. Delving deeper, let’s explore more advanced examples of customizations that can fine-tune your visual design within Godot:

Suppose you want your game’s UI to respond dynamically to player interactions beyond the basic hover and pressed states. We can go a step further and add effects like changing the font color or implementing a custom drawing for a hovered button. Here’s how:

Adjusting the font color on the hover state:

var button_hover_style = new_theme.get_stylebox("hover", "Button").duplicate()
button_hover_style.bg_color = Color(0.25, 0.25, 0.25)
var button_hover_font_color = Color(1, 1, 0)
new_theme.set_color("font_color_hover", "Button", button_hover_font_color)

Now when you hover over a button, not only will the background change, but the font color will become a bright yellow, making it instantly recognizable.

If you want custom drawings on your UI controls, such as a border around a hovered button, you can use the following approach with scripting:

class CustomButton inherits Button:
    var border_color = Color(1, 0, 0)
    func _draw():
        if is_hovered():
            draw_rect(Rect2(Vector2(), rect_size), border_color, false)

func _ready():
    var custom_button =
    custom_button.text = "Hover Over Me"
    custom_button.connect("draw", custom_button, "_draw")

This will draw a red border around the button when the mouse hovers over it, adding an elegant touch to your UI’s interactivity.

Now, moving onto dialogs. Setting up a dialog box that fits your game’s Theme is crucial for things like story text, player choices, or system messages. Here’s an example:

var dialog_background_style =
dialog_background_style.bg_color = Color(0.11, 0.14, 0.17, 0.95)
new_theme.set_stylebox("panel", "WindowDialog", dialog_background_style)

var dialog_font = font.duplicate()
dialog_font.size = 18
new_theme.set_font("title_font", "WindowDialog", dialog_font)
new_theme.set_font("font", "WindowDialog", font)

This customizes the dialog background to be slightly transparent and sets different font sizes for the title and the body text of the dialog box, ensuring readability and style coherence.

For scrollable lists like the ItemList node, which could be used for inventory or menu options, you’d want to make sure they integrate well with your Theme:

var item_list_bg_style =
item_list_bg_style.bg_color = Color(0, 0, 0, 0.8)
new_theme.set_stylebox("bg", "ItemList", item_list_bg_style)

This gives the list a slightly transparent background, fitting with the overall dark Theme we’ve been designing.

Focusing on dropdown menus accessed through the OptionButton node, styling them consistently with your Theme could look like this:

var option_button_style =
option_button_style.bg_color = Color(0.2, 0.3, 0.4)
new_theme.set_stylebox("normal", "OptionButton", option_button_style)

var option_font_color = Color(1, 1, 1)
new_theme.set_color("font_color", "OptionButton", option_font_color)

This will style your dropdown menus with the same color scheme as other buttons while keeping the font color white for contrast and readability.

As a final example of advanced Theme customization, let’s look at making an interactive slider more dynamic:

var hslider_grabber_highlight =
hslider_grabber_highlight.bg_color = Color(0.8, 0.8, 0.8)
var focused = "focus"
new_theme.set_stylebox(focused, "HSlider", hslider_grabber_highlight)

With this snippet, whenever the HSlider is focused, the grabber will become much lighter, intuitively indicating that it’s the active UI element.

These advanced customizations illustrate how Themes can be both diverse and detailed, allowing for a rich and unified user interface experience that is uniquely tailored to your game’s visual narrative. By embracing the full potential of the Theme resource in Godot, you create a professional and immersive interface that elevates gameplay and engages players on a deeper level.

Continuing Your Godot Journey

Mastering Themes in Godot is a significant milestone on your path to becoming a skilled game developer. However, the world of game development is vast, and there’s always room to grow your skills and knowledge. When you’re ready to take the next step and truly dive into the art of creating immersive games, Zenva’s Godot Game Development Mini-Degree is the perfect place to continue your journey.

Our Mini-Degree covers a wide spectrum of game development topics, from the basics of Godot 4 to intricate game mechanics across various genres. Whether you are just starting out or looking to sharpen your existing skills, the course content is designed to be engaging and practical. You’ll have the opportunity to build your very own games, earn certificates for your achievements, and create a professional portfolio that showcases your talent.

Furthermore, if you’re interested in exploring a broader range of courses or seeking out specific Godot tutorials to suit your interests, be sure to check our comprehensive selection of Godot courses. At Zenva, we equip you with the tools to go from beginner to professional, supporting you every step of the way in your game development career.


We’ve taken an enlightening journey through the workings of Themes in the Godot Engine, and you’re now equipped with the knowledge to bring cohesion, elegance, and personal touch to your game’s UI. Remember, a game’s interface is one of the first elements that players interact with, so it’s paramount to invest time in creating an engaging user experience. Ready to put these tutorials into action? Dive headfirst into honing your game creation skills and bring your imaginations to life with Zenva’s Godot Game Development Mini-Degree.

Don’t stop at Themes—there’s a world of game development techniques and secrets awaiting your discovery. Whether your interest lies in pixel art, 3D modeling, or mastering various programming languages, your learning adventure is limitless with Zenva. Forge your path to becoming a game development maestro, and join a community of like-minded creators today. The playground of virtual worlds is vast, and with Zenva, you’re never alone on the path to achieving your game development dreams.

Python Blog Image

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