---
name: "usdtree"
section: "1"
platform: "linux"
package: "usd"
version: "26.11.1-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/usdtree"
---

# usdtree(1)

manual page for usdtree 26.11.1

## NAME

usdtree - manual page for usdtree 26.11.1

## SYNOPSIS

**usdtree** \[*OPTIONS*\] *inputPath*

## DESCRIPTION

usdtree : Writes the tree structure of a USD file. The default is to inspect a single USD file. Use the **--flatten** argument to see the flattened (or composed) Stage tree. Special metadata 'kind' and 'active' are always shown if authored unless **--simple** is provided.

### Positionals:

- inputPath TEXT REQUIRED

  The input file to process

## OPTIONS

- **-h**,--help

  Print this help message and exit

- **--unloaded**

  Do not load payloads.

- **-a**,--attributes

  Display authored attributes.

- **-m**,--metadata

  Display authored metadata (active and kind are part of the label and not shown as individual items

- **-s**,--simple

  Only display prim names: no specifier, kind or active state.

- **-f**,--flatten

  Compose the stage with the input file as the root layer and write the flattened content.

- **--flattenLayerStack**

  Flatten the layer stack with the given root layer. Unlike **--flatten**, this does not flatten composition arcs (such as references).

- **--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**.