ColorPickerButton in Godot – Complete Guide

What is the ColorPickerButton in Godot 4?

Imagine you’re creating the next hit game and want to allow players to customize their characters with a vibrant color palette. The ColorPickerButton is here to save the day! It’s a user interface (UI) element in the Godot Engine that displays a button, which, when pressed, pops up a ColorPicker control. This handy widget gives users the power to select colors and fine-tune them to their liking within your game seamlessly.

What is it for?

The ColorPickerButton is primarily used for allowing in-game customization and color selection. Whether you’re tweaking the hue of a player’s outfit, changing the ambient lighting in a room, or choosing the color for a drawing app within the game, this control can be utilized to provide an interactive experience for color selection within a Godot 4 project.

Why Should I Learn It?

Learning how to implement the ColorPickerButton elevates your game’s interactivity and user experience. By integrating this element, you provide users with the creative freedom to personalize aspects of the game environment or characters. Gaming is all about immersion and personalization, and what’s a better way to captivate players than letting them splash their favorite colors all over their in-game universe?

Furthermore, understanding the workings of common UI controls like the ColorPickerButton is essential for game development. It’s a crucial skill that will come in handy as you craft intuitive interfaces and engage with the Godot Engine’s powerful GUI system. So let’s get started and explore how to use the ColorPickerButton with some practical coding examples!

CTA Small Image

Creating a Basic ColorPickerButton

First off, we’ll begin by creating a simple ColorPickerButton. This basic example will show you how to add the button to your scene and respond to the color change.

extends Control

func _ready():
    var color_picker_button =
    color_picker_button.connect("color_changed", self, "_on_ColorPickerButton_color_changed")

func _on_ColorPickerButton_color_changed(color):
    print("Selected color: ", color)

This script creates a new ColorPickerButton instance programmatically in the _ready() function and adds it to the scene. It also connects the "color_changed" signal to a callback function that will print the selected color to the console.

Customizing ColorPickerButton Properties

Next, let’s modify the appearance and default behavior of the ColorPickerButton. You can set properties such as the initial color, popup mode, and button text.

color_picker_button.color = Color(1, 0, 0) # Set initial color to red
color_picker_button.flat = true # Remove the button's 3D effect
color_picker_button.text = "Choose Color" # Set button text

The above lines of code configure the initial color to red, flatten the button to remove the 3D effect, and change the button text to “Choose Color”. These customizations can be set right after creating the ColorPickerButton.

Embedded ColorPicker

Suppose you want the ColorPicker to be always visible instead of displaying in a popup. Godot allows embedding the ColorPicker directly into the scene.

color_picker_button.popup = false # Disable popup
var color_picker = color_picker_button.get_picker()

With popup set to false, the ColorPicker will not appear in a separate dialog. The get_picker() method retrieves the actual ColorPicker control, which can then be added to the scene tree as a direct child.

Setting up Advanced ColorPickerButton Signals

Now, let’s dig into more advanced signal handling. Apart from monitoring color changes, you might want to respond to other user interactions, such as when the popup is about to open or when the user picks a preset color.

# Connecting additional signals
color_picker_button.connect("popup_closed", self, "_on_ColorPickerButton_popup_closed")
color_picker_button.connect("preset_added", self, "_on_ColorPickerButton_preset_added")

func _on_ColorPickerButton_popup_closed():
    print("ColorPicker popup was closed.")

func _on_ColorPickerButton_preset_added(color):
    print("A preset was added with color: ", color)

The "popup_closed" signal is emitted when the ColorPicker popup is closed, whereas the "preset_added" signal is emitted whenever a color is added as a preset. By handling these signals, you can create more nuanced interactions within your game.

By now, you’ve seen how to create a simple ColorPickerButton, customize it, embed the picker into the scene, and handle various user interactions. With these examples, you’re on your way to mastering the use of the ColorPickerButton in your Godot 4 projects. Stay tuned for the next part of our tutorial, where we will delve deeper into leveraging the ColorPickerButton’s full potential!

To further enhance your Godot 4 skills, we’ll explore more advanced implementations and features of the ColorPickerButton, adding a touch of sophistication to your game’s color customization capabilities.

When you’re incorporating a ColorPickerButton into a complex user interface, you might want to customize its popup’s appearance as well. Godot provides several settings to tweak how the color picker looks and feels when it pops up.

# Configuring popup's exclusive setting
var popup = color_picker_button.get_popup()
popup.rect_min_size = Vector2(400, 300) # Set minimum size of the popup

Here, we’re setting the minimum size for the ColorPicker popup to ensure it has enough space to include all of its components comfortably.

Perhaps you want to save color presets between game sessions. Godot’s ColorPicker has a built-in ability to manage presets, which can be easily saved and loaded using the following code:

func save_color_presets(presets):
    var file ="user://color_presets.cfg", File.WRITE)

func load_color_presets():
    var file =
    if file.file_exists("user://color_presets.cfg"):"user://color_presets.cfg", File.READ)
        var presets = file.get_var()
        return presets
    return []

# Load presets on startup
func _ready():
    var presets = load_color_presets()
    for preset in presets:

The save_color_presets() function writes an array of color presets to a configuration file while load_color_presets() reads them when the game starts, populating the ColorPicker with previously selected colors.

If you’re aiming to provide feedback or immediate application of the selected color, you can update your game’s objects in real-time as the player chooses a color:

func _on_ColorPickerButton_color_changed(color):
    # Assuming you have a Sprite node named 'player_sprite'
    var player_sprite = get_node("player_sprite")
    player_sprite.modulate = color

In the snippet above, every time a new color is chosen, the modulate property of a hypothetical ‘player_sprite’ node is updated, showing the color change instantly.

For games where precise color selection matters, you might want to give players the ability to enter exact color values. The ColorPickerButton allows users to input RGBA or HEX values, which you can enable as follows:

# Enabling direct color input
var color_picker = color_picker_button.get_picker()
color_picker.hide_presets()  # Hide preset colors if necessary
color_picker.enable_raw_mode(true)  # Enable raw mode input for precise color values

With raw mode enabled, users can type in specific color values, granting them the accuracy they need for more meticulous customizations.

Don’t forget, the ColorPicker can also operate in an HSV (Hue, Saturation, Value) mode, which might be more intuitive for some applications and users:

# Switching to HSV mode
color_picker.toggle_hsv_mode() # Switches between RGB and HSV mode

Flipping between RGB and HSV modes can give your players a different approach to selecting the color that best fits their needs.

With Godot’s flexible ColorPickerButton and the ability to create and modify its components through code, you are empowered to design a deeply personalized and interactive color selection experience for your players. By incorporating the above techniques into your Godot 4 projects, you elevate your game development skills and ultimately, the quality of your game. We hope you found these advanced examples insightful and that they’ll help you implement engaging color customization features for your players. Dive in and start experimenting to see what amazing color-driven designs you can create!

Following the exploration of customization options for the ColorPickerButton, let’s delve further into scripting functionalities that you could use to extend the capabilities of your in-game color palette. We’ll take a closer look at how you can synchronize multiple ColorPickerButtons and make use of Godot signals to enhance your game’s UI.

When dealing with multiple ColorPickerButtons, you might want to make sure they stay synchronized, sharing the same color across different parts of the UI:

var primary_color_picker_button =
var secondary_color_picker_button =
primary_color_picker_button.connect("color_changed", self, "_on_PrimaryColor_changed")

func _on_PrimaryColor_changed(color):
    secondary_color_picker_button.color = color

In the example above, any change in the primary ColorPickerButton will automatically update the secondary one, ensuring color consistency throughout your UI.

Another useful feature is to create dynamic feedback loops in your UI. By manipulating the signals, you can change properties of other UI elements in response to color selections:

func _on_ColorPickerButton_color_changed(color):
    var color_indicator = get_node("ColorIndicator")
    color_indicator.rect_color = color

Here, a UI element (possibly a simple rectangle) is used to immediately show the selected color, providing instant visual feedback to the player.

Now let’s look at an example where we use the color picker to affect a game object’s shader parameters, allowing for real-time graphical adjustments:

func _on_ColorPickerButton_color_changed(color):
    var game_object_material = get_node("GameObject").material
    game_object_material.set_shader_param("color_param", color)

In this case, a shader parameter is updated on the fly with the selected color. This could be used for effects like changing the color of a magic spell or the tint of a character’s armor.

Advanced users might want to integrate custom color presets that are based on gameplay elements or narrative themes:

func apply_narrative_color_presets():
    var presets = [Color(0.8, 0.4, 0.2), Color(0.3, 0.2, 0.5)] # Example theme colors
    for preset in presets:

Bringing narrative into your mechanics can be a subtly powerful tool, and by utilizing thematic color presets, you can enhance the storytelling within your game’s environments and characters.

For scenarios where you want to restrict player color choices to a specific palette, you can easily remove the ability to freely pick any color:

func restrict_colors_to_palettes(palette_colors):
    var color_picker = color_picker_button.get_picker()
    color_picker.disable_floating_picker() # Remove the floating picker
    color_picker.hide_slider() # Hide the sliders if needed
    color_picker.clear_presets() # Clears current presets if necessary
    for color in palette_colors:

This way, your players would be able to choose only from the pre-approved colors, which might be essential for maintaining visual coherence or compliance with branding guidelines in the game.

To conclude, the ColorPickerButton in Godot is not just a simple color selection tool but also a versatile element that can be adapted to a wide array of game environments and uses. By understanding and utilizing the depth of its functionality through Godot’s scripting, you can provide an interactive and customized experience for your players. Whether adjusting shaders in real-time, syncing multiple color pickers, or setting thematic presets, the possibilities with the ColorPickerButton are virtually limitless. Embrace the flexibility of Godot and let your creativity run wild with colors!

Continuing Your Journey in Game Development

Having explored the vibrant landscape of the ColorPickerButton in Godot 4, you’ve taken significant strides on your game development journey. However, the quest for knowledge never ends! To help you keep evolving as a developer and to apply your newfound skills in more complex scenarios, consider diving into our Godot Game Development Mini-Degree. This comprehensive selection of courses will equip you with the tools and understanding you need to take full advantage of Godot 4’s capabilities.

Whether you’re a newcomer or a seasoned game creator seeking to polish your skills, the Mini-Degree offers valuable insights into using 2D and 3D assets, mastering GDScript, and implementing diverse game mechanics. By the end of the program, you’ll be well on your way to creating your first game in under two hours — a real testament to the power of Godot 4’s user-friendly yet robust environment!

If you’re eager to broaden your Game Development skills further with Godot, we also offer an array of other Godot courses that cater to various interests and levels of expertise. Here at Zenva, we commit to enhancing your learning experience with high-quality content that’s accessible whenever and wherever you’re ready to level up. Keep learning, keep creating, and, most importantly, keep enjoying the process!


Embarking on the colorful journey of the ColorPickerButton in Godot 4 is just the beginning of what you can achieve with this incredible game engine. We at Zenva are excited to accompany you as you build, experiment, and innovate your way to creating exceptional games that resonate with players around the world. Remember that every line of code you write and every UI widget you implement brings you one step closer to turning your game development dreams into reality.

Extend your creative palette and further elevate your projects by exploring our Godot Game Development Mini-Degree. It’s designed to provide a structured pathway to mastery, setting you on the course towards becoming a confident and capable game developer. The future of game creation awaits, and we’re here to chart the course. Let’s make the gaming world a more interactive and colorful place together!

Python Blog Image

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