Adjust Actor Properties

Modify properties of an Actor such as applying Materials, Physics, Scale through the Details panel.


Once you place an Actor in your level, you can modify the way it looks or functions in your Level. With the Actor selected in the Level, inside the Details panel you will find information about the Actor that can be modified. This How To demonstrates some sample use cases for accessing the Details panel and modifying Actor properties.

Over the course of this guide, we will change several properties that will affect an Actor in our Level, such as scaling the Actor to increase its size, applying a Material, turning on Physics for the Actor, and tweaking Collision Settings so that it registers when it hits other Actors during gameplay.

1. Working with Actor Transforms

An important part to working with Actors is to understand the process of

[Transforming Actors](Basics/Actors/ManipulatingActors)
, which includes the moving, rotating and scaling of an Actor as well as defining its Mobility (whether an Actor will be allowed to move or change in some way during gameplay). In this step, we will focus on using the Details panel to adjust transformations for a selected Actor to set its location, scale and moblity in the Level.

For this How To guide, we will be using a new project using the Blueprint Third Person template with Starter Content enabled. If you have not created a project based off a template before or are not sure how to enable Starter Content, refer to the Create a New Project page for information on creating and opening projects, templates, and project settings.


  1. With your Project open, inside the Content Browser open the Content/StarterContent/Shapes folder.

  2. Drag the Shape_Sphere into the viewport just above the stairs in the Level.


  3. When the Actor is placed, its data populates the Details panel in the lower-right portion of the editor.

  4. Inside the Details panel under Transform, click the lock icon for Scale and set the XYZ values to 3.0.


    Clicking the lock icon will ensure that the X, Y, and Z values scale uniformly rather than independently of one another.

    As you make the changes, the sphere in the Level updates to the new values.


  5. Set the Location values for XYZ to -140.0, 380.0, and 350.0 respectively and set the Mobility to Movable.


    This moves the Actor up in the air slightly above the stairs and enables its ability to change during gameplay.

End Result

The Location, Scale and Moblity for our Actor was set via the Details panel directly, however you can also manipulate Actors inside the viewport using the

[Transform tools](Basics/Actors/ManipulatingActors)
. Using properties in the Details panel is useful when you need things to line up percisely or need exact numerical values.

Next up, update the Material applied to the Actor through the Details panel.

2. Applying Materials to Actors

Once you have an Actor in your Level to work with, you can quickly alter the appearance of the Actor by changing its Material through the Details panel. In this step, we will assign a Material through the Material property in the Details panel and assign a Material from the Content Browser.


  1. Scroll down in the Details panel to the Materials category and click the Select Material dropdown.


  2. In the menu that appears, the currently selected Material is highlighted. Select any new Material.


    When you select a Material, the dropdown updates with your selection and the sphere in the Level will updates.

  3. Click the magnifying glass icon next to the Select Material dropdown.


    Clicking this icon automatically finds and selects the Material inside the Content Browser.


    This is useful for finding assets in the Content Browser when you do not know where they are located.

  4. In the Details panel, click the yellow arrow icon.


    Whenever you click this icon, it will reset the option back to its default value.


  5. In the Content Browser, select another Material.


  6. In the Details panel, click the arrow icon next to the Select Material dropdown.


    Clicking this icon will automatically assign the asset selected in the Content Browser to the option's setting.


    When you see this icon next to a property, you can select something in the Content Browser then click it to assign it to the property.

End Result

We learned how to assign a Material to an Actor through the Actor's Material property value in the Details panel and a way to locate items in the Content Browser that are assigned to a property. We also saw how to assign items from the Content Browser directly to a property by clicking the assign short-cut.

In the next step, we will take a look at the Physics & Collision properties of an Actor to enable physics simulation on our sphere so when we launch the game, the ball will drop and roll down the stairs and collide with our playable character killing them in the process.

3. Adjusting Actor Physics & Collision

We will adjust the Physics for our Actor as well as the Collision properties inside the Details panel. By adjusting these settings we can define how an Actor responds to other Actors in the game world. We can set our Actor to simulate physics which will allow us to bump into and push the Actor around in the world as well as define how it responds to collision with other Actors.


  1. With the Shape_Sphere selected, in the Details panel under Collision, check the Simulation Generates Hit Events checkbox.


    With this option checked, we can determine if the sphere hits something.

  2. Also in the Collision section, click the Collision Presets dropdown and select Physics Actor.


    Since we are going to simulate physics, this setting will handle the physics responses for us.

  3. In the Physics section, check the Simulate Physics checkbox.


    There are additional options you can set here, such as the Damping or Contraints, which can affect how physics for the Actor is simulated, however for this tutorial all we are going to do is simulate physics so it can be affected by physics during gameplay.

    If you play in the editor now, you will see the sphere roll down the stairs and you can walk into it and push it around since it is a Physics Actor. In order to test the Hit Events, we will use a little bit of Blueprint Visual Scripting to kill the player when hit by the sphere.

  4. With the sphere selected in the Level, on the Main Toolbar click the Blueprints button, then select Open Level Blueprint.


1.Right-click in the graph window, then under Add Event for Shape Sphere and Collision, select the Add On Actor Hit event.


This will now fire an event when the sphere hits something. 
  1. From the OnActorHit node, drag off the Other Actor pin and search for Cast To ThirdPersonCharacter then select it in the window.


    Here we are checking to see if the Other Actor we hit is the ThirdPersonCharacter (or Player used with this template).

  2. Drag off the As Third Person Character pin of the Cast node and search for and add the Destroy Actor node.


    If ThirdPersonCharacter was the Other Actor hit, then destroy ThirdPersonCharacter (killing the player character).

  3. Click the Compile button in the upper-left corner of the window to finalize the Blueprint, then close the window.


  4. From the Main Toolbar, click the Play button to play in the editor.


End Result

When you play in the Editor now, you can use the WASD keys to move the character around and the mouse to manipulate the camera. You should see that the sphere now rolls down the stairs and if you walk into it, it should kill the character making them disappear (press Esc to exit the play session after you have been "killed").

This should give you a brief understanding of how to edit the properties of Actors through the Details panel of the main Level Editor. For more information, please see the related topics below.

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey