CanvasGroup in Godot – Complete Guide

Welcome to a journey into the world of game development using Godot 4, where we’ll dive deep into the wonders of the CanvasGroup class. As we explore the potentials of grouping and optimizing 2D nodes, you’ll discover the power this tool unleashes for more efficient and visually appealing game creation. The CanvasGroup class is a gem hidden within the Godot engine that can significantly enhance gaming experiences, and we’re excited to unfold its capabilities together. Prepare to bring your game development skills to the next level by mastering a feature that’s as practical as it is powerful.

What Is CanvasGroup?

The CanvasGroup class in Godot 4 is a versatile tool that behaves as a parent for multiple 2D nodes, integrating them into a single draw operation. This functionality grants developers more control over the rendering process and can lead to performance optimizations in 2D projects.

What Is It For?

The primary purpose of a CanvasGroup is to group multiple CanvasItem nodes, allowing them to be rendered distinctly. For instance, you can create overlapping translucent 2D nodes that won’t blend into each other, or implement custom shaders for advanced visual effects. If you’ve ever faced challenges with layering or drawing numerous 2D elements efficiently, CanvasGroup reveals an elegant solution.

Why Should I Learn It?

Having a solid grasp of CanvasGroup paves the way for creating rich, composite 2D visuals in your games. It’s a skill that adds to your development arsenal, enabling:

– Improved performance by reducing draw calls.
– Creative freedom with custom shaders.
– Greater control over 2D node rendering.

By learning how to implement and utilize the CanvasGroup, you can both enhance the quality of your games and streamline your development process. Let’s dive into the specifics and learn through practical examples in the upcoming sections.

CTA Small Image

Creating a Simple CanvasGroup

To get started with CanvasGroup, begin by creating a new node in your Godot project. Here’s how you can set up a basic CanvasGroup and add a couple of 2D nodes as its children:

var canvas_group =

var sprite_one =
var sprite_two =


This snippet initializes a new CanvasGroup and two sprites, which are then added to the CanvasGroup. With this setup, you now have a group that you can manipulate as a single entity.

Modifying CanvasGroup Properties

CanvasGroup has various properties that control how the children nodes render on screen. Below, see how to adjust the visibility and opacity of all nodes within a CanvasGroup:

canvas_group.visibility = false # Hide all children
canvas_group.visibility = true # Show all children

canvas_group.opacity = 0.5 # Set half transparency to all children

These properties provide a straightforward way to control the appearance of group members without the need to loop through individual nodes.

Applying Effects with CanvasGroup

A powerful feature of CanvasGroup is the ability to apply effects, like shaders, to the entire group. Here’s an example of how to apply a shader to a CanvasGroup:

var shader_material =
shader_material.shader = load("res://path_to_your_shader.shader")

canvas_group.material = shader_material

By linking a shader to the CanvasGroup’s material, any effect in that shader now affects all children nodes simultaneously. This opens up a world of possibilities for visual creativity.

Animating CanvasGroup Properties

Animations can bring life to your games, and it’s no different with CanvasGroup properties. Here’s an example of how to animate the opacity of a CanvasGroup using a Tween node:

var tween =

tween.interpolate_property(canvas_group, "opacity", 1.0, 0.0, 2, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)

This will animate the opacity of the entire group from fully visible to completely transparent over 2 seconds, creating a fade-out effect without the need to animate each node individually.

The CanvasGroup class is just one aspect of Godot 4 that can revolutionize your game creation process. By leveraging these examples, you will be well on your way to mastering it. Stay tuned for the next part, where we will continue with more in-depth examples.Let’s delve deeper into the capabilities of the CanvasGroup class in Godot 4 and harness its full potential in your game development projects.

If you want to control the blend mode of the entire group, changing how the nodes’ visuals combine with the background, you simply adjust the blend mode like this:

canvas_group.set("blend_mode", CanvasItem.BLEND_MODE_ADD)

This code snippet changes the blend mode to additive, making every child node in the CanvasGroup render with an effect that adds their colors to the background, ideal for creating glowing effects or magic spells.

Suppose you want to change the CanvasGroup’s render order among other nodes. You can manipulate the z-index to ensure it’s drawn on top of or beneath other nodes:

canvas_group.z_index = 10

This small change can drastically affect the visual stacking of elements in the game, an essential tool for UI elements, foreground objects, or background scenery.

For more interactive experiences, you may want to toggle the entire group’s interactivity without affecting each child node individually. Easily enable or disable mouse input for the entire group:

canvas_group.mouse_filter = CanvasItem.MOUSE_FILTER_PASS
canvas_group.mouse_filter = CanvasItem.MOUSE_FILTER_STOP
canvas_group.mouse_filter = CanvasItem.MOUSE_FILTER_IGNORE

The MOUSE_FILTER_PASS allows events to pass through to other nodes, while MOUSE_FILTER_STOP will stop the event from propagating further, and MOUSE_FILTER_IGNORE ensures the group doesn’t block or pass any mouse events.

When working with a CanvasGroup, you may occasionally want to apply a transformation to it that affects all its child nodes, such as scaling or rotating the group:

canvas_group.set_scale(Vector2(1.5, 1.5)) # Scale up by 50%
canvas_group.set_rotation(deg2rad(45))        # Rotate by 45 degrees

Transformations like these can help in creating dynamic scenes where group elements need to rotate around a point or change in size together — all without the need to apply these transformations to each node separately.

Lastly, let’s examine how you can dynamically adjust the layering of nodes within the CanvasGroup to create depth and parallax effects on the fly:

foreach canvas_item in canvas_group.get_children():
    canvas_item.z_index += 1

This loop increments the z_index of each child, pushing them one layer up, causing a layered visual effect that can make your scenes pop with depth.

With these additional code examples, you’re enhancing your understanding of the CanvasGroup class in Godot 4. By practicing these techniques, your games can benefit from optimized performance, powerful effects, and dynamic interactions. Continue experimenting with CanvasGroup’s features and witness your 2D game environments transform in surprising and delightful ways.Let’s push our exploration of the CanvasGroup class a bit further and see how we can dynamically interact with the children of a CanvasGroup. For manipulations that affect all children simultaneously, we iterate over each child node:

// Change the modulate property of all children to red
foreach (var child in canvas_group.get_children()) {
    if (child is CanvasItem) {
        child.modulate = Color(1, 0, 0, 1) // Pure red with full opacity

Sometimes, you not only want to modify properties but also invoke methods on all children nodes. For example, you might want to show or hide all children based on some game event:

// Hide all children nodes
foreach (var child in canvas_group.get_children()) {
    if (child is CanvasItem) {
// Show all children nodes
foreach (var child in canvas_group.get_children()) {
    if (child is CanvasItem) {

In some scenarios, you may want to fine-tune which children receive specific modifications. This can be accomplished by filtering nodes using their type or name:

// Increase the alpha of all "Sprite" nodes within the group
foreach (var child in canvas_group.get_children()) {
    if (child is Sprite) {
        var sprite = child as Sprite
        sprite.modulate = sprite.modulate + Color(0, 0, 0, 0.1)

For even more precise control, you might wish to leverage signals to create responsive interactions between your CanvasGroup and the rest of the scene:

// Connect a signal to all button nodes within the group to respond to click events
foreach (var child in canvas_group.get_children()) {
    if (child is Button) {
        child.connect("pressed", self, "_on_Button_pressed")

// The callback method for the button "pressed" event
private void _on_Button_pressed() {
    GD.Print("A button within the CanvasGroup was pressed!")

One of the strengths of CanvasGroup is the capacity to rapidly switch between various states. Let’s say you have a collection of nodes that should alternate between different sets of visual properties depending on the game context:

// Toggle visibility and modulate for a 'stealth' effect
bool stealth_mode = false

public void ToggleStealthMode() {
    stealth_mode = !stealth_mode
    Color stealth_color = stealth_mode ? new Color(0.5, 0.5, 0.5, 0.5) : new Color(1, 1, 1, 1)
    canvas_group.opacity = stealth_mode ? 0.5f : 1.0f
    foreach (var child in canvas_group.get_children()) {
        if (child is CanvasItem) {
            child.modulate = stealth_color

These code examples broaden your understanding of the practicality of CanvasGroup and how its use can enrich your scenes and gameplay mechanics. As you integrate these snippets into your projects, remember that CanvasGroup is not just a performance tool; it’s a creative asset that can amplify your game’s visual and interactive experiences. Continue experimenting and building on this knowledge to develop games that stand out in both efficiency and elegance.

Continue Your Godot Learning Journey

The world of game development with Godot is vast and full of potential, and your journey to mastery doesn’t end here. After delving into the nuances of the CanvasGroup class, it’s time to take your skills even further. We encourage you to continue your exploration and growth in this exciting field. Whether you’re a beginner eager to learn the basics or an experienced developer looking to polish your craft, our Godot Game Development Mini-Degree is designed to take you step by step through the various aspects of game creation with Godot.

Beyond our Mini-Degree, our wide range of Godot courses cover different topics and difficulty levels to suit your needs. Through these comprehensive courses, you’ll learn about the latest Godot features, enhance your GDScript proficiency, and work on practical projects that will contribute to a robust portfolio. At Zenva, our goal is to provide you with the knowledge and tools necessary to transform your game development aspirations into reality.

Keep coding, keep creating, and remember that with each new skill, you unlock a new realm of possibilities. Join us at Zenva, where learning is an ongoing adventure, and every course brings you one step closer to achieving your game development dreams.


The CanvasGroup class in Godot 4 is a powerful addition to any game developer’s toolkit, and mastering it is a massive leap forwards in creating engaging, interactive, and visually stunning games. By understanding how to effectively use CanvasGroup, you’re equipping yourself with the knowledge to optimize game performance, enhance the visual experience, and simplify your development workflow. Your journey through the realms of Godot doesn’t stop here — it’s just the beginning. So take these learnings, experiment with your projects, and watch your games come to life.

Ready to advance your Godot skills? Head over to our Godot Game Development Mini-Degree and continue crafting your path in the world of game development. With each new lesson, project, and line of code, you’re building not just games but the foundation of an exciting career in game development. At Zenva, we’re excited to be part of your journey and can’t wait to see the amazing games you’ll create. Keep learning, keep growing, and let’s build incredible gaming experiences together!

Python Blog Image

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