.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH USDTREE "1" "September 2026" "usdtree 26.08" "User Commands"
.SH NAME
usdtree \- manual page for usdtree 26.08
.SH SYNOPSIS
.B usdtree
[\fI\,OPTIONS\/\fR] \fI\,inputPath\/\fR
.SH DESCRIPTION
usdtree : Writes the tree structure of a USD file. The default is to
inspect a single USD file. Use the \fB\-\-flatten\fR argument to see the
flattened (or composed) Stage tree. Special metadata 'kind' and
\&'active' are always shown if authored unless \fB\-\-simple\fR is provided.
.SS "Positionals:"
.TP
inputPath TEXT REQUIRED
The input file to process
.SH OPTIONS
.TP
\fB\-h\fR,\-\-help
Print this help message and exit
.TP
\fB\-\-unloaded\fR
Do not load payloads.
.TP
\fB\-a\fR,\-\-attributes
Display authored attributes.
.TP
\fB\-m\fR,\-\-metadata
Display authored metadata (active and kind are part of the label and not shown as individual items
.TP
\fB\-s\fR,\-\-simple
Only display prim names: no specifier, kind or active state.
.TP
\fB\-f\fR,\-\-flatten
Compose the stage with the input file as the root layer and write the flattened content.
.TP
\fB\-\-flattenLayerStack\fR
Flatten the layer stack with the given root layer. Unlike \fB\-\-flatten\fR, this does not flatten composition arcs (such as references).
.TP
\fB\-\-mask\fR 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 \fB\-\-flatten\fR.