User Manual

Assets

The Assets Panel manages all of the Assets that are available in your project. From here, you can create, upload, delete, inspect and edit any Asset.

Assets Panel

Folder Hierarchy

The folder panel allows you to organize your assets into a tree of folders.

To create a new Folder, select the Add Asset (+) button and select 'Folder'. Alternatively, right click the folder where you would like a new folder to be created and select 'New Asset' > 'Folder'.

To rename a folder, double click it in the hierarchy panel and edit the Name field in the Inspector.

To delete a folder, double click it in the hierarchy and hit delete. Alternatively, right click the folder you want to delete and select 'Delete' from the context menu.

Folders can be drag and dropped into each other if you want to reorgnize your folder structure.

Creating and Uploading Assets

You can create new assets by dragging a file from you computer's file system into the Assets Panel. The Editor will upload and import the asset for you.

You can also create certain assets types using the Add Asset (+) icon.

You can delete assets by selecting them and clicking the Delete Asset icon.

Editing Assets

Certain text-based assets can be opened and edited in the PlayCanvas Script Editor: text, json, shader, html, css and script assets. To do this, simply double click on the asset's thumbnail.

Inspecting Assets

To inspect the details of any given asset, select its thumbnail in the Assets Panel. The asset's details will be displayed in the Inspector.

Filtering

Filter which assets are visible using the filter drop down to select the type of asset to view.

Searching

You can perform a global search for assets in your project using the Search box. Simply start typing into the box and the Editor will show matching results dynamically in the Assets Panel.

RegExp - it is possible to search using regular expressions. Add * at the beginning of search field and type regexp query after. To search for all assets use *. (any character) regexp query.

Tags - To search by tags and their combinations type tags in square brackets [ ]. Simple query operators: AND, OR are allowed by expressing query as array of strings or other arrays with strings. Logic of query is same as for findByTag from AssetsRegistry.
Here are some examples:

[ level-1 ] - returns all assets that are tagged by level-1.
[ level-1, level-2 ] - returns all assets that are tagged by level-1 OR level-2.
[ [ level-1, monster ] ] - returns all assets that are tagged by level-1 AND monster. Notice extra brackets.
[ [ level-1, monster ], [ level-2, monster ] ] - returns all assets that are tagged by (level-1 AND monster) OR (level-2 AND monster).

Drag and Drop

Assets can be moved to different folders by dragging them from the main panel to a folder in the folder hierarchy. Note that assets support multi-selection. Pressing CTRL+A will select all assets in the currently selected folder.

You can also drag Assets from the Asset Panel to highligted slots in the Inspector. Slots in the Inspector will either be asset attributes of components or asset-type script attributes.

You can also drag model, material, and cubemap assets directly into the Viewport

Checking References

Sometimes it's useful to know where assets are being used (or referenced) within a particular scene. If the Editor cannot detect any references for an asset, a small dot will be displayed on its thumbnail:

Unreferenced Asset

Note that the Editor cannot detect references to assets that are made in code. So think carefully before you delete an asset based on this indicator!

If an asset does have references, you can check them via the References content menu item:

Asset References

Selecting a reference will load it into the Inspector panel.