> For the complete documentation index, see [llms.txt](https://docs.siminsights.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.siminsights.com/hyperskill-studio-authoring/state-machine-reference/actions/translate.md).

# Translate

Translate moves an object in space to a set position over a set time. A detailed explanation of controls and interface functions is described in the section [State Machine Builder User Interface](https://docs.google.com/document/d/1-o5qSv4zTkzj7YSmRTkV4zezFq7lwU00FyTy0kw1l1U/edit#bookmark=id.6vu41emx3478).

1. Within the edit Simulation section of the HyperSkill Desktop application, navigate to the State Machine tab.
2. Click on the desired state and, from the dropdown in either the entry or exit actions, select the type Translate.
3. Press the + button to add the action to the action list.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FCxOyAcx45idZ7KLMxr1O%2F104.png?alt=media&#x26;token=922147ba-e062-4238-ac9f-e4850ef55595" alt=""><figcaption></figcaption></figure>

4. Select the entity of the object you wish to translate in space with the Select Entity dropdown.
5. Enter the x, y and z coordinates the object should be translated to. You can translate in Global Space or Local Space. If an object is not snapped into anything, Local Space behaves like Global Space.
6. Select the mode:
   * **Set** sets the position to the specified value.
   * **Add** adds the specified value to the object's current position.
   * When using Local Space with Add, the scale of the parent object affects how far a child object is translated. If the parent object is scaled smaller, the child object is also translated less.
7. Use the Speed field to set the amount of time the object takes to go from its current location to the end destination. This value must be greater than or equal to 0.

**Note:** If the object is not Kinematic, it will likely behave erratically as other forces, such as gravity or collisions, act on it.

To turn an object instead, see [Rotate](/hyperskill-studio-authoring/state-machine-reference/actions/rotate.md).