Skip to main content

Asset Usage Report

The Asset Usage Report shows you everywhere a specific asset is referenced in your project — which scenes, actors, triggers, and script events use it. This is useful for understanding dependencies before modifying or deleting an asset.

Viewing Asset Uses​

There are two ways to open the usage report:

From the Asset Editor​

In any asset editor (Backgrounds, Sprites, Palettes, Music, Sounds, Fonts, Localizations), click the dropdown menu and select View Uses.

Asset editor dropdown showing View Uses option

From the Navigator​

Right-click any asset in the Navigator sidebar and select View Uses from the context menu.

Navigator context menu with View Uses

Reading the Results​

The usage list shows all entities that reference the selected asset:

Asset usage results showing scenes and actors
  • Scenes appear at the top level (e.g., a scene using the asset as its background).
  • Actors and triggers appear nested under their parent scene.
  • Custom events appear if any custom script references the asset.
  • The total count is shown in the header.

If the asset is not used anywhere, a message indicates it is safe to remove.

Click any entry in the list to navigate directly to it:

  • Scene entries — Selects and focuses the scene. If the match is in a script event, the correct script tab is opened and the view scrolls to the event.
  • Actor/Trigger entries — Selects the actor or trigger within its scene and navigates to the matching script event if applicable.
  • Custom Event entries — Opens the custom event editor.
tip

The scan runs on a background thread and won't block the editor. For tileset assets, TMX map file references are also detected.