> For the complete documentation index, see [llms.txt](https://help.intangible.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.intangible.ai/build/transform.md).

# Transform

Move, rotate, scale objects with the gizmo. Two coordinate-space modes plus surface, vertex and grid snapping.

Move, rotate, and scale objects in the viewport. The gizmo has two coordinate-space modes and three kinds of snapping; learn which is which and you'll stop fighting it.

![Transform popover open in Build mode with numeric Position (X / Y / Z), Rotation (X / Y / Z), and Scale (X / Y / Z) fields](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-c198e03c69cd7237fcd04a0f3e8ace74b266849b%2Ftransform-popover-build-01.png?alt=media)

## What it does

Moving objects in 3D is where the muscle memory you brought from Blender, Maya, or Unreal stops helping. Intangible's transform gizmo is deliberately simpler than what you're used to – position, rotation, and scale on each axis, plus a center cube for uniform scale – and it has two coordinate-space modes depending on what you're trying to do.

Common pitfalls include scaling an object to zero and losing its handle, or letting snapping launch an object outside the camera frustum. The fixes are below.

## How to use it

Select an object in the viewport. The gizmo and the contextual menu appear. The contextual menu's transform panel has direct numerical entry for X, Y, Z position, rotation, and scale – use it for precise placement when dragging is too coarse.

![An object selected in a large scene with the transform panel open, showing its exact position values](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-7b344b8b225a12834de2c41d3f5de5a7ebd86984%2Ftransform-precise-placement-01.png?alt=media)

The numbers matter most once a scene is big. Dragging a prop into place across a city block is guesswork; typing the position is not.

For rough placement, drag the gizmo handles directly:

1. **Move along an axis.** Click and drag a single arrow handle for X, Y, or Z translation.
2. **Move on a plane.** Click and drag the small square between two arrows for two-axis translation.
3. **Rotate.** Click and drag a circle handle. Each circle corresponds to one rotation axis.
4. **Scale per axis.** Click and drag the cube handles at the ends of the X, Y, or Z axes for non-uniform scale.
5. **Uniform scale.** Click and drag the white cube at the center of the gizmo to scale the object uniformly on all three axes at once.

Drag toward the edge of the screen and hold the cursor there: the view pans in that direction, so a long move doesn't stop where the screen does. The same applies while moving spline points or drawing a spline with the pencil or pen.

### Gizmo modes

The dropdown lists Global, Local and Smart Transform, plus a fourth entry, Motion Path, that appears only when the selected object is on a path. The split is not what the name "coordinate space" suggests: Global and Local are the same gizmo, the classic three-axis one described above, pointed at two different frames of reference, while Smart Transform is a separate gizmo with its own handles.

* **Global**: the classic gizmo, handles aligned to world axes. Up is up regardless of how the object is rotated. Use this when you want predictable world-space movement.
* **Local**: the same classic gizmo, handles aligned to the object's own axes. Critical when you're moving objects relative to themselves – putting a phone in someone's hand, attaching a prop to a moving vehicle.
* **Smart Transform**: the default. Where Global and Local render the classic gizmo, this one renders a different gizmo built from four handles – elevation, orientation, scale, and snap – for dropping an object onto a surface and turning it to face where you want rather than nudging it along an axis.

![The transform space dropdown open, showing Global, Local and Smart Transform](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-2b3eb8ea4d97364242de71207a60d50778231970%2Ftransform-space-modes-01.png?alt=media)

**Motion Path** hides the gizmo while you work along the path, and leaving it restores whichever of the other three you were in before. See [Motion paths](https://help.intangible.ai/build/motion-paths.md).

## Snapping

Snapping lands what you drag on something solid: a surface, the corner of a mesh, or a point on the world grid. It is off until you turn it on, and it stays the way you left it. Changing the selection, dropping an asset from the library or Alt-dragging a copy no longer switches it off.

Turn it on with the snapping toggle at the right end of the contextual menu, or press `B`. The toggle's tooltip reads **Toggle snapping**. To snap for a single drag without turning it on, hold `Ctrl` while you drag.

![The snapping toggle switched on at the right end of the contextual menu, with its tooltip: Toggle snapping, B / CTRL + Drag. The Snapping options chevron sits beside it](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-b47f5e4ed3c60e35045152f8473bae9a14e105fe%2Fsnapping-toggle-01.png?alt=media)

### Snapping options

The small chevron beside the toggle, **Snapping options**, swaps the contextual menu for the snapping panel. The arrow at its left end takes you back.

| Control                   | What it does                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------- |
| **Snapping type**         | **Surface**, **Vertex** or **Grid**. Picking one also turns snapping on.                                |
| **Grid size**             | Only with Grid. The cell size in meters, 1 m to start. Type a value or drag the arrow icon to scrub it. |
| **Parent to snap target** | Also parents the object to whatever it lands on. Not offered with Grid, which has nothing to parent to. |
| **Snapping space**        | Only with Surface. **Bounds** or **Origin**, see below.                                                 |

![The snapping options panel in place of the contextual menu, with Back, Snapping type, Parent to snap target and Snapping space, and the Snapping space menu open on Bounds (ticked) and Origin](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-ff4b3bbc9700679d2d30f07edfb65cb6403e08fe%2Fsnapping-modifiers-01.png?alt=media)

The three types:

* **Surface** lands the object on the surface under the cursor.
* **Vertex** lands the object's origin on the nearest corner of the face under the cursor. On something with no faces, like the floor or a Gaussian splat, it lands on the point you are pointing at instead.
* **Grid** lands the object's origin on the nearest point of a world grid. Set its spacing with **Grid size**.

### Bounds and Origin

Surface snapping has two spaces. **Bounds** is the default and lands the side of the object that faces the surface: its bottom on a floor, its top on a ceiling, its back on a wall. A lamp snapped to a ceiling hangs from it instead of sinking into it.

**Origin** lands the object's pivot on the surface instead. Use it when the pivot is where you want the contact, like a door hinge.

Vertex and Grid always use the origin.

On uneven ground, Bounds sorts each surface into floor, ceiling or wall rather than following every facet's tilt. A surface within 45° of level counts as floor (or ceiling), and the object's base lands centred on the point under the cursor. Steeper faces count as walls. This stops a tree dragged across faceted terrain from swinging sideways. The trade-off: on a slope the base sinks a little into the uphill side instead of resting tangent to it.

When you snap a parent, Vertex, Grid and Origin-space snaps use the parent's own origin and ignore its children, so a child hanging below the parent doesn't drag the landing point down. Bounds-space snaps still use the box around the parent and its children, because that box is the shape you are placing.

### Keys while you drag

| Key          | Tap                                 | Hold while dragging                           |
| ------------ | ----------------------------------- | --------------------------------------------- |
| `B`          | Turns snapping on or off            |                                               |
| `X`          | Picks Grid and turns snapping on    | Snaps to the grid for that drag               |
| `C`          | Picks Surface and turns snapping on | Snaps to surfaces for that drag               |
| `V`          | Picks Vertex and turns snapping on  | Snaps to vertices for that drag               |
| `Ctrl`       |                                     | Snaps for that drag with your chosen type     |
| `Ctrl` + `⇧` |                                     | Snaps and parents to what the object lands on |

A held key lasts for that drag only and never changes your settings, so letting go of `Ctrl` doesn't switch off snapping you turned on yourself. A quick tap in the middle of a drag switches the type for the rest of the drag and after it. `Ctrl` + `C` and `Ctrl` + `V` still copy and paste; they never change the snap type. Holding `X`, `C` or `V` keeps your **Parent to snap target** setting. Only `Ctrl` decides parenting: hold `⇧` with it to parent, leave `⇧` off not to.

`Ctrl` is the Control key on a Mac too, not `⌘`.

While a snap is active, a small badge sits just above the cursor with the snapping icon and the type you are snapping with, **Surface**, **Vertex** or **Grid**. It shows for move drags only, not rotate or scale, and on the elevation handle only with Grid.

![Dragging a box toward a table with snapping on: the badge above the cursor reads Surface, a tap of V mid-drag switches it to Vertex, and the box snaps to the table's corner and lands there](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-be6798232808e17d3aabd515f312abedd2356927%2Fsnap-cursor-badge-01.gif?alt=media)

### Snapping along one axis

Dragging a single axis arrow snaps too, and the object stays on that axis. It slides along the arrow to the snap point instead of jumping off the line. This works in Local mode, along the object's own axes, and on the origin handles in Edit Origin.

### Parenting on snap

Parenting on snap is opt-in. If you want the relationship – a prop riding on a moving vehicle – turn on **Parent to snap target**, or hold `Ctrl` + `⇧` while you drag. If you just want clean placement – a plane set down on a runway that shouldn't follow the runway – leave it off. To set or clear a parent directly, use the [Parent tool](https://help.intangible.ai/build/working-with-objects.md#parenting); to detach an existing child, see [Selection and grouping](https://help.intangible.ai/build/selection-and-grouping.md#parent-attachments).

Dragging an asset in from the library always snaps to a surface and parents, for that drop only. Your own snapping settings are left as they were.

Turn snapping off when it is fighting you. It tries hard, sometimes too hard.

## Move the origin, not the object

Rotation and scale happen around an object's origin. When that origin sits somewhere unhelpful, a door that swings from its centre instead of its hinge, no amount of careful rotating fixes it.

**Edit Origin** moves the pivot without moving what you see. It sits in the **…** menu on the contextual toolbar when a single object that supports it is selected, and `O` opens it without going through the menu.

1. **Select the object** and choose **Edit Origin**, or press `O`.
2. **Drag the origin** with the axis or planar handles, or turn its axes with the rotation rings. A small white sphere marks it and stays visible while you drag. The small toolbar under the gizmo carries **Gizmo Mode** beside the snapping controls. Snapping works here too, with the type and grid size only: an origin never parents, and always snaps by its own point.
3. **Leave the mode** with the X in the bottom toolbar, `Esc`, or `O` again.

**Reset Origin** sits beside the exit and puts the pivot back where the asset had it.

On a group, Edit Origin moves the group's pivot and leaves its members where they are, at every frame. The rotation handles turn the group's axes without moving its contents, so you can line a group up before you animate it. Edit Origin follows the world / local toggle (`T`). On a group, **Reset Origin** puts the pivot back at the center and bottom of its members.

`Esc` does two jobs here: mid-drag it cancels the drag, and with no drag running it exits the mode. So pressing it twice from inside a drag gets you out.

![Edit Origin after a drag: the origin gizmo and its white sphere sit on the ground beside the figure, which has not moved, with the Gizmo Mode and snapping toolbar under the gizmo and X and Reset Origin in the bottom toolbar](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-ab474fb3f7e4ac6ff82afe53230dd11acc48b870%2Fedit-origin-02.png?alt=media)

![Edit Origin active on a character: the origin gizmo at the figure's feet with axis arrows, planar handles and a rotation ring, a small toolbar with Gizmo Mode and snapping under it, and X and Reset Origin in the bottom toolbar](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-a86b434c5ff5bfd44d7984d16a55b6bd59f8bf65%2Fedit-origin-01.png?alt=media)

## Details

| Control                                    | Where it lives                                                                           |
| ------------------------------------------ | ---------------------------------------------------------------------------------------- |
| Direct numerical entry                     | Contextual menu → Transform panel                                                        |
| Uniform scale handle                       | White cube at the gizmo's center                                                         |
| Gizmo mode                                 | Coordinate-space toggle in the toolbar                                                   |
| Snapping on / off                          | Snapping toggle at the right end of the contextual menu, or `B`                          |
| Snapping type, grid size, parenting, space | **Snapping options** chevron beside the snapping toggle                                  |
| Parent tool                                | Contextual menu, right after Transform – click a target to set, click the floor to clear |

## Common mistakes

* **Object scaled to zero.** Scaling along all three axes to zero makes the object unselectable in the viewport and unreachable from the gizmo. Recover via the [Scene Outliner](https://help.intangible.ai/build/scene-outliner.md): find the object by name to select it, then re-enter a non-zero scale value in the Transform panel.
* **Object disappeared off-screen.** Snapping plus a fast drag can launch an object well outside the camera frustum. Fix from the Scene Outliner: select the row, press `F` to frame, then enter clean position values in the Transform panel.
* **Wrong axis when posing characters.** A character moved in Global mode rotates around world-up; in Local mode it rotates around its own spine. Use Local for character poses where the figure isn't facing the world axes.

## Related

* [Working with objects](https://help.intangible.ai/build/working-with-objects.md)
* [Selection and grouping](https://help.intangible.ai/build/selection-and-grouping.md)
* [Scene Outliner](https://help.intangible.ai/build/scene-outliner.md)
* [Asset library](https://help.intangible.ai/build/asset-library.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.intangible.ai/build/transform.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
