USDTREE(1)

💅 USDTREE(1) — the manual page, but make it bestie ✨

okay so real talk, this is the manual for usdtree version 26.11.1 and it's literally about to make your USD files make sense. no cap.

---

🌸 NAME 🌸

usdtree — the manual page for usdtree 26.11.1, bestie. that's the whole vibe.

---

🦋 SYNOPSIS 🦋

usdtree [OPTIONS] inputPath

---

🎀 DESCRIPTION 🎀

usdtree writes the tree structure of a USD file, and honestly? iconic behavior. the default is to inspect a single USD file. use the --flatten argument when you wanna see the flattened (or composed) Stage tree — that's the main character energy right there.

special metadata 'kind' and 'active' are always shown if authored, unless you pass --simple. periodt.

🧚 Positionals 🧚

• inputPath TEXT REQUIRED — the input file to process. you gotta give it a file, bestie, it's required fr fr.

---

✨ OPTIONS ✨

• -h, --help — print this help message and exit. slay, classic.
• --unloaded — do not load payloads. like, leave them unloaded, okay?
• -a, --attributes — display authored attributes. show me what you got 👀
• -m, --metadata — display authored metadata. quick heads up: active and kind are part of the label and not shown as individual items (iykyk).
• -s, --simple — only display prim names: no specifier, kind or active state. minimal, clean, lowkey gorgeous.
• -f, --flatten — compose the stage with the input file as the root layer and write the flattened content. this one goes off 💅
• --flattenLayerStack — flatten the layer stack with the given root layer. unlike --flatten, this does not flatten composition arcs (such as references). important distinction, don't @ me.
• --mask PRIMPATH[,PRIMPATH...] — limit stage population to these prims, their descendants and ancestors. to specify multiple paths, either use commas with no spaces, or quote the argument and separate paths by commas and/or spaces. requires --flatten. read that again, bestie — it's required.

⚠️ heads up: --mask will not work unless you've also passed --flatten. the audacity, honestly, but that's the rules.

---

muah 💋 that's the whole page. written for usdtree 26.11.1 — dated October 2026 — and yeah, that's the version and the date, so you know exactly what you're working with. stay slay, bestie, and go read some trees. 🌈💖