Working with Assets

How to create, delete, and manage Assets from the Content Browser.

Choose your operating system:

Windows

macOS

Linux

In Unreal Engine 5, you can create, delete, and manage Assets directly from the Content Browser. This page describes common Asset workflows, and explains what Asset references are and how to handle moving or deleting your Assets in the editor. Further, you will explore how to export some types of Assets from Unreal Engine into a format that other applications can import.

Creating Assets

To create a new Asset, right-click inside a blank area of the Content Browser. Then, from the context menu that appears, choose the Asset you want to create. This creates a blank Asset of the type you specified. For some Assets, like Blueprints, you can select additional options, like the Blueprint's parent class.

Unlike importing Assets, which brings something you made in an external application into Unreal Engine, this method creates a blank Asset which you can populate with content.

Asset References

If an Asset makes use of another Asset in some way, we say that the Assets reference (or have a reference to) each other. For example, if a Cube Actor uses a Color Material, the Actor references that Material. This is why it is important to make sure that references are updated whenever you move or rename an Asset, and that you remove any references to an Asset before you delete it.

Viewing Asset References

To view an Asset's references, right-click the Asset in the Content Browser. Then, from the context menu that appears, select Reference Viewer. A new window will open that displays a visual representation of the Asset's references.

For more information about the Reference Viewer, refer to the Finding Asset References page.

Copying Asset References

To copy one or more Assets' references to the clipboard, select the Asset or Assets in the Content Browser. Then, right-click your selection and, from the context menu that appears, select Copy Reference.

References contain the Asset type and the path to the .uasset file. They will look similar to the examples below:

    Material'/Game/StarterContent/Materials/M_Metal_Brushed_Nickel.M_Metal_Brushed_Nickel'
    Material'/Game/StarterContent/Materials/M_Metal_Burnished_Steel.M_Metal_Burnished_Steel'
    Material'/Game/StarterContent/Materials/M_Metal_Chrome.M_Metal_Chrome'

This is useful if you need to paste the Asset's reference in a text field, or if you need to generate an external list of Assets.

Replace References Tool

The Replace References Tool provides a way to combine multiple Assets into a single one.

To learn more about this tool, refer to the Replace References tool page.

Managing Assets

To perform common Asset actions, right-click the Asset and select the desired action from the context menu that appears. These actions include:

Action

Description

Edit

Opens the selected Asset in its Editor. For example, performing this action on a Blueprint opens it in the Blueprint Editor.

Rename

Makes the Asset's name editable. To rename the Asset, type a new name and press Enter. After you rename the Asset, Unreal Engine will update all references to the Asset to its new name.

Duplicate

Creates a copy of the selected Asset at the current location. To relocate the copy, drag it to another folder.

Save

Saves the selected Asset.

Show in Folder View

Highlights the Asset's parent folder in the folder tree. Useful for finding the actual location of Assets that are part of a collection.

Show in Explorer (Windows) / Show in Finder (Mac)

Opens an instance of Windows Explorer or Finder at the Asset's location on disk. This is the location of the .uasset file.

Never move, copy, or delete Assets directly on disk, as this might break functionality in your project and lead to data corruption or data loss. Always manage .uasset files through Unreal Editor.

If you need to move an Asset from one project to another, refer to the Migrating Assets page to learn how to do this.

Moving and Copying Assets

You can move or copy Assets and folders in your project through the Content Browser.

The steps to moving or copying an Asset are:

  1. Click the Asset you want to move, then drag it to another folder in the Content Browser or folder tree. As you drag the Asset, a popup window will follow your mouse cursor, indicating which Asset you are trying to move.

    Moving an Asset with drag-and-drop

  2. When you release the mouse button, a menu will appear.

    Move Asset menu

    The menu confirms the folder name and contains a list of three options:

Option

Description

Move Here

Moves the Asset to the new location.

Copy Here

Creates a copy of the Asset at the new location, and leaves the original Asset at its current location.

Advanced Copy Here

Creates a copy of the Asset at the new location, and attempts to automatically resolve all of that Asset's references and dependencies. This option includes an additional save dialog where you need to confirm that you want to save the Asset you copied.

Deleting Assets

To delete an Asset, you can either:

  • Right-click it in the Content Browser. Then, from the context menu that appears, select Delete.

  • Select the Asset in the Content Browser, World Outliner, or Level Viewport, then press Delete on your keyboard.

This action will bring up a confirmation window. If your Asset isn't being referenced anywhere (that is, it's not being used anywhere in your Unreal project), click the Delete button to confirm:

Deletion confirmation window

If your Asset is being referenced somewhere, the confirmation window will notify you of this and ask you what you want to do. There are two types of referencing that can happen:

  • If the Asset is referenced by other Assets, it means that another Asset in your project is using this one. For example, if you are trying to delete a Material, and a Static Mesh uses that Material, you will see this warning.

  • If the Asset is referenced in memory, it could be open in a separate editor window, or it might have been used recently and is still cached in memory.

    If you are seeing zero Asset References, but at least one Memory Reference, close all other editor windows and try again. If that doesn't work, save your work and restart Unreal Engine.

In this situation, you have two options:

Deleting an Asset that still has references

  • If you select Replace References, you can choose another Asset to replace this one wherever it is referenced in your project. For example, if a Static Mesh uses a Material, and you want to delete that Material, you can choose a different Material that the Static Mesh will use after the deletion.

  • If you select Force Delete, the Asset will be deleted without any additional corrections being performed.

    This can cause data corruption and data loss. At a minimum, Assets that reference the deleted one will no longer work correctly, but this can break your entire project.

Exporting Assets

Assets in your project are stored on disk as .uasset files, which is a file format specific to Unreal Engine. Exporting an Asset saves it to disk in a format that can then be read by other applications.

To export an Asset from your project, right-click it in the Content Browser. Then, from the context menu that appears, select Asset Actions > Export. This will open a window where you can name your exported Asset and select the location where to save it.

The file type available for export will change depending on the type of Asset you selected. For example, for a Static Mesh Asset, you will see the options to export it as an FBX, OBJ, COPY, or T3D file.

Not all Assets can be exported.