# Is Render Target

## Introduction

`Is Render Target` controls whether all instances contained in this container render directly to the screen (if false), or if they first render to their own dedicated target before rendering to the screen (if true).

`Is Render Target` defaults to false (unchecked).

`Is Render Target` enables a number of graphical effects including:

* Container [Alpha](/gum/gum-tool/gum-elements/general-properties/alpha.md) (transparency)
* Container [Blend](/gum/gum-tool/gum-elements/general-properties/blend.md)
* Alpha-only [Blend](/gum/gum-tool/gum-elements/general-properties/blend.md#alpha-only-blends) modes on instances contained in the Container

{% hint style="warning" %}
As of February 2025 the `Is Render Target` variable is considered experimental. You may experience issues when using this as it is being developed. Please report any problems you find through GitHub or on Discord.
{% endhint %}

## Is Render Target Clips Children

Containers with Is Render Target set to true automatically clip their children. This behavior is the same as setting [Clips Children](/gum/gum-tool/gum-elements/general-properties/clips-children.md) to true. This happens because render targets internally create a texture which matches their size. Therefore, any items which are placed outside of the bounds of a render target container are not rendered.

<figure><img src="/files/sOAmld1oZqzsG7SliYIQ" alt=""><figcaption><p>Is Render Target set to true clips children</p></figcaption></figure>

## Using Is Render Target for Special Effects

Once a container is rendered to a render target, additional special effects can be applied at runtime. These include:

* Scaling
* Rotating
* Rendering portions using texture coordinates

For more information see the [SpriteRuntime RenderTargetTextureSource](/gum/code/standard-visuals/spriteruntime/rendertargettexturesource.md) documentation.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flatredball.com/gum/gum-tool/gum-elements/container/is-render-target.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
