> For the complete documentation index, see [llms.txt](https://docs.thunkable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thunkable.com/snap-to-place/stage.md).

# Stage

## Current Stage

![](/files/-MG86xBAmfEuDCUnO8tv)

Select which Stage to display in the Canvas.

## Stage Appearance

### Set Background Color&#x20;

![](/files/-MXlxr3MdYYj9Iz7DtkZ)

Sets the background color of the specified Stage.

### Get Background Color&#x20;

![](/files/-MXlxwSdNzICYSYPGD8g)

Returns the hexadecimal value of the background color for the specified Stage.

### Set Frame Color&#x20;

![](/files/-MXly0_TFSIMvISiIc8F)

Sets the color of the Frame for the specified Stage.

### Get Frame Color&#x20;

![](/files/-MXly5mGDG0SqNVSURjh)

Returns the hexadecimal value of the Frame Color for the specified Stage.

### Set Image Number to&#x20;

![](/files/-MARPheU_fAh37QUuKla)

Set the background image of the stage to the specified item in the list.

## Stage Gravity&#x20;

Please refer to the [Canvas docs](https://docs.thunkable.com/canvas#gravity) to see some animated examples of the gravity properties.

### Set Y Gravity&#x20;

![](/files/-MXlyE4mKSJd9s2kXxhx)

Sets the Stage gravity in the vertical direction.

### Get Y Gravity&#x20;

![](/files/-MXlyKHOFGyY8rMFgIp8)

Returns the value of the Stage gravity, in the vertical direction.&#x20;

### Set X Gravity

![](/files/-MXlyPXTyIDRJ-ZsOtHd)

Sets the Stage gravity in the horizontal direction.

### Get X Gravity

![](/files/-MXlyTzuYgivGWg4zZgg)

Returns the value of the Stage Gravity, in the horizontal direction.&#x20;

## Drawing

### Set Touch Drawing&#x20;

![](/files/-MXlyZCJPJauPswB2lav)

Enable drawing on the stage if set to `true`.&#x20;

Disable drawing on the stage if set to `false`.

### Get Touch Drawing&#x20;

![](/files/-MXlydQdzcoo-Wxyoifu)

Return true or false, depending on whether or not drawing is enabled on the Stage.&#x20;

### Set Drawing Color&#x20;

![](/files/-MXlypqb5VTnIBxhxOqG)

Set the Drawing Color, or Line Color, for the stage.

### Get Drawing Color&#x20;

![](/files/-MXlyvPXNIbhkd4cdqbH)

Returns the hexadecimal value of the Drawing Color for the specified Stage.

### Set Drawing Width&#x20;

![](/files/-MXlz0iqRmccZ_IjdNin)

Set the Drawing Width, or Line Width, for the stage.

### Get Drawing Width

![](/files/-MXlz68zp1Xy6D0zwsCc)

Returns the numeric value for line width on the Stage.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.thunkable.com/snap-to-place/stage.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.
