GUID Find-Usages
Given a GUID or an asset, lists every path under Assets/ that references it.
Editor-only. Unity 2021.3+. Lives in Anvil.Editor (includePlatforms: Editor). No extra packages.
Editor window
ArTchie / Anvil / GUID Find-Usages
Object field + GUID text field (they stay in sync) and:
| Button | What it does |
|---|---|
| Find | Searches text assets / .meta files for the guid and walks AssetDatabase.GetDependencies. |
| Copy JSON | Puts the report JSON on the clipboard. |
| Write report | Writes <project>/AnvilReports/guid-usages.json (creates the folder if needed). |
The target asset and its own .meta are omitted. Skips Packages/ and Library/.
Batchmode (CI)
Unity -batchmode -nographics -quit -projectPath <proj> -executeMethod Anvil.GuidFindUsages.RunBatch -anvil-guid <guid> -anvil-out <file.json>
or
Unity -batchmode -nographics -quit -projectPath <proj> -executeMethod Anvil.GuidFindUsages.RunBatch -anvil-asset Assets/Art/Hero.png
| Arg | Meaning |
|---|---|
-anvil-guid <guid> |
32 hex chars (dashes / braces optional). Required unless -anvil-asset is set. |
-anvil-asset <path> |
Project asset path used to resolve the guid. |
-anvil-out <file.json> |
Output path. Default: <project>/AnvilReports/guid-usages.json |
-anvil-fail |
Exit code 1 if any usages were found; otherwise 0 |
If neither -anvil-guid nor -anvil-asset is passed (or the guid/path cannot be resolved), batch exits 1 and logs an error.
RunBatch only calls EditorApplication.Exit when Application.isBatchMode is true. It logs guid=, count=, and the output path.
Also accepts -anvil-guid=… / -anvil-asset=… / -anvil-out=file.json.
JSON
{
"tool": "GuidFindUsages",
"generatedUtc": "2026-08-18T02:00:00Z",
"guid": "deadbeefdeadbeefdeadbeefdeadbeef",
"assetPath": "Assets/Art/Hero.png",
"count": 1,
"items": [
{
"assetPath": "Assets/Art/Hero.mat",
"kind": "text"
}
]
}
kind values: text (file contents contain the guid), meta (a .meta other than the target’s), dependency (AssetDatabase.GetDependencies direct hit, no text match).
assetPath at the root is "" when the guid does not map to a current project asset (orphaned guid search still runs the text pass).
Notes
- Text search covers the same YAML/text set as Unused Asset Finder, plus unknown files that look like text. Binary files are not grepped; the dependency pass covers those.
- One row per referencing path (text/meta wins over dependency).
- Empty projects, a missing guid, and a missing
AnvilReportsfolder are fine (count0). - Does not modify assets. Does not touch runtime player code.
Source in the box: Assets/ArTchie Studios/ArTchie-Suite/com.artchie.anvil/Documentation/GuidFindUsages.md