> For the complete documentation index, see [llms.txt](https://learn.shapesxr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.shapesxr.com/objects-creation/text-tool.md).

# Text Tool

Call the Toolbar (A/X button) and choose the Text Tool. In the opened menu you can set font size, alignment, font type, and color of the future text. You can change these options before or even while creating your text.

### **How to create text**

Create text in your space by holding the trigger button and marking a text area. After you release the trigger button, the keyboard will appear. Type your text on the keyboard and click on the Done button. 

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV5IFh3rk5kqfCwJPPYhE%2Fuploads%2FaIVJMgyrv8AE0BoYtSf9%2Ftextcreation-crop-video.mp4?alt=media&token=c96e5fd4-f3cc-4e3c-9efb-ff2b356653a3>" %}

You can grab the keyboard by the special handle on the bottom using the trigger and move it to any convenient location in your scene.

To resize the Text box, activate the [Gizmo](/objects-manipulation/gizmo.md), then grab and drag the circle handles.

You can also add text on any surface. Bring the cursor to the surface, and when the circle appears, hold the trigger and mark a text area.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV5IFh3rk5kqfCwJPPYhE%2Fuploads%2F9PK7zBHS6nw4r4yLtGip%2Ftextonsurface-crop-video.mp4?alt=media&token=83b8b5dc-7054-4a83-ab36-bcaf64e097e0>" %}

### How to edit text

Select the text with the Select Tool and trigger button to open the [Object Inspector](/object-inspector.md) and change this text's properties, such as text type and size, alignment, position, color, and text itself.&#x20;

Click on the Text field so the keyboard appears and you can edit your text. Click on Done on the keyboard to apply changes.&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV5IFh3rk5kqfCwJPPYhE%2Fuploads%2FFQaVk19K6cbHY0ZbynwY%2Ftextediting-crop-video.mp4?alt=media&token=35962059-4bd4-43dd-81b1-b1f87643d989>" %}


---

# 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, and the optional `goal` query parameter:

```
GET https://learn.shapesxr.com/objects-creation/text-tool.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.