> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altoura.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Teleport User To

> Move the learner's viewpoint and camera position to a specific location in the scene

## Overview

The **Teleport User To** action instantly repositions the learner's camera viewpoint to a new location and orientation in the 3D scene. This guides the learner's perspective to the right place at the right time without requiring them to navigate manually.

## When to Use

* **Guide perspective during steps** — Automatically move the learner's view from a wide overview to a close-up of a specific component
* **Reposition for each new step** — Reset the learner's viewpoint at the start of each training phase
* **Focus attention** — Direct the learner's gaze to the next action point automatically
* **Ensure visibility** — Guarantee the learner can see critical details from the optimal angle

## Parameters

| Parameter       | Type                  | Required | Description                                                                                 |
| --------------- | --------------------- | -------- | ------------------------------------------------------------------------------------------- |
| Target Position | Vector3 (X, Y, Z)     | Yes      | The 3D coordinates where the camera will teleport to (distance in meters from scene origin) |
| Target Rotation | Vector3 or Quaternion | Yes      | The direction the camera will face (pitch, yaw, roll or quaternion orientation)             |

## Example

**Move learner to examine a control panel**

```
Action: Teleport User To
Target Position: [2.5, 1.5, -3.0]
Target Rotation: [0, 45, 0]
```

The camera instantly moves to coordinates (2.5, 1.5, -3.0) and faces 45 degrees along the Y axis, pointing at the control panel.

**Return to overview position**

```
Action: Teleport User To
Target Position: [0, 5, 5]
Target Rotation: [-30, 0, 0]
```

The learner returns to a bird's-eye view of the entire scene.

## Tips

* Use in **onEntry** to position the learner before instructions appear
* Combine with **Show Panel** to display instructions alongside the new viewpoint
* Record multiple waypoints as reference points: save the camera position/rotation for key areas of your scene
* Transition between positions smoothly by:
  * Teleporting to an intermediate position briefly
  * Using small position increments across multiple steps
  * Letting the learner manually navigate between teleport points for spatial awareness
* Test camera positions on mobile devices — ensure nothing is cut off at smaller screen sizes

## Related Actions

* **Disable Self Teleport** — Lock the learner in place after you teleport them
* **Set Interactable Objects** — Restrict interactions to objects now visible in the new viewpoint