Unreal Engine 5 Documentation has been moved to the Epic Developer Community

Transforming an Actor in Unreal Engine refers to moving, rotating, or scaling it (in other words, adjusting the position, orientation, and / or size of the Actor). This page describes how to perform each of these actions, as well as some of the commonly used keyboard shortcuts when working with Actors.

There are two ways to transform Actors in the Unreal Editor:

• Manual transformation

• Interactive transformation

Manual Transformation

You can do manual transformation through the Transform section of the Details panel. When you select one or more Actors in the Level Viewport , you can view and edit their Location , Rotation , and Scale in this section. Where applicable, this section also contains Actor mobility settings.

Each Transform property has numeric entry fields for the X, Y, and Z axes. You can type specific values directly into these fields to adjust the selected Actors, or click inside a field and drag your mouse up or down to adjust that field's value.

If more than one Actor is selected, and their Location or Rotation has multiple values, the relevant fields will display Multiple Values . In this case, if you enter a number it will overwrite that value for all selected Actors. Note that this may cause the Actors to overlap.

To reset an Actor's Location , Rotation , or Scale to their default values after you've made changes, click the Reset to Default button ( ).

You can lock the Scale fields by clicking the Lock Scale button ( ). When locked, the values for each axis (X, Y, and Z) change in unison, which allows for uniform scaling and prevents distortion.

Transform properties default to relative coordinate space, which means the transform occurs relative to the Actor's parent. You can toggle between relative and world transforms by clicking the dropdown arrow next to a property label. World transforms occur relative to world coordinates instead of the Actor's parent. For more information, see the World and Local Transformation Modes section on this page.

Interactive Transformation

You can do Interactive transformation directly inside the Level Viewport , using a visual tool called a gizmo . Sometimes, a gizmo can also be called a widget ; in Unreal Engine, these terms mean the same thing.

A gizmo is made up of several parts that are color-coded according to which axis they affect:

• Red represents the X axis.

• Green represents the Y axis.

• Blue represents the Z axis.

You can use transformation gizmos to move, rotate, or scale Actors.

The gizmo takes different forms depending on what type of transformation is being performed: translation, rotation, or scale. You can choose which type of gizmo you want to use by clicking its icon in the Level Viewport toolbar, which is located in the upper-right section of the viewport, or by using keyboard shortcuts.

Translation Gizmo

The Translation gizmo is a set of color-coded arrows pointing down the positive direction of each axis in the world. Use it to move an Actor along an axis, a plane, or freely.

Click an arrow and drag an arrow to move the selected Actor along that axis.

To move an Actor along two axes simultaneously, click the square at the point where the two axes meet, then drag to move the Actor along the plane defined by the two axes (XY, XZ, or YZ).

To move the Actor freely along all three axes, click and drag the white sphere at the point where all three axes intersect.

Duplicating an Actor Using the Translation Gizmo

To duplicate an Actor, hold down the Alt key, then click and drag a Translation gizmo arrow. This creates and moves a duplicate of the selected Actor, leaving the original unchanged at the starting position.

Rotation Gizmo

The Rotation gizmo is a set of three color-coded arcs, each associated with one axis. When you drag one of the arcs, the selected Actor rotates around that axis. For this gizmo, the axis affected by any one of the arcs involved is the one perpendicular to the arc. For example, the arc aligned to the XY plane rotates the Actor around the Z axis.

When you hover the cursor over a particular arc, that arc turns yellow, indicating that you can drag it to rotate the Actor. When you start to rotate the Actor, the gizmo changes shape to show only the axis around which the Actor is being rotated. The amount of rotation is displayed in real time to help you gauge your progress.

Scale Gizmo

The Scale gizmo has handles that end in cubes. When you drag the gizmo by one of these handles, you scale the selected Actor only along the associated axis. The handles are color-coded by axis, similar to the Translation and Rotation gizmos.

You can scale an Actor along two axes simultaneously in the same way you can use the Translation gizmo to move an Actor along a plane defined by two axes. Each axis is connected to each other axis with a line that forms a triangle. These triangles align with one of the three planes (XY, XZ, YZ). Dragging one of these triangles scales the Actor along both axes that define that plane. When the mouse hovers over one of these triangles, the associated handles turn yellow.

You can also scale an Actor along all three axes, thus maintaining its original proportions. If you hover the cursor over the cube where all three axes meet, all three handles turn yellow. Dragging by that center cube scales the Actor proportionally.

World and Local Transformation Modes

When using the interactive transformation method, you can choose which reference coordinate system you want to use when performing the transformation. This means you can transform the Actor in accordance to either:

• World space - that is, along the world axes, or

• The Actor's local space - that is, along its local axes.

The example below shows the difference between world and local space, using a Static Mesh Actor.

By default, the Unreal Editor starts out in world transformation mode. To switch to local transformation mode, click the Globe icon in the Level Viewport toolbar. The globe turns into a cube icon, indicating that you are now in local transformation mode. Click the cube to switch back to world coordinates.

Adjusting an Actor's Pivot Point

When transforming Actors, you typically perform your transforms from the base pivot of the Actor. If you have a transformation gizmo enabled, you can see the pivot point where the three axes of that gizmo intersect.

You can adjust the location of an Actor's pivot temporarily by middle-clicking on the sphere in the center point of the Translation gizmo and dragging to move the pivot. You can then transform the object around the new pivot point.

Keyboard Shortcuts

Below are some of the common keyboard shortcuts when working with Actors.