Add a USD reference in the Outliner

References are one mechanism that can be used to create a USD set, which is a single complex asset compiled from individual USD assets. References let you load the same layer file multiple times into a single scene in different locations, reusing scene description. This lets you load scene description (ie. a model, asset) from an external location without copying it into the contents of the layer referencing it. In the following example, shot_sets.usd is referencing the file book.usd.

Important: Referencing is not instancing. Marking a prim as instanceable simply indicates that it can be instanced. USD decides if it is instanced or not.

Note: References are not given a type. In USD, references are typically a type-less def, which contains no information. This is useful when you reference a prim from another file, because a type-less def can easily take on a prim's type without interference.

Add a reference to a prim in the Outliner

  1. Right-click the prim you want to add a reference to.

  2. Select Add Reference.

  3. In the Add Reference to USD Prim file dialog that appears, select your reference file.

    Important: The reference appears in the Viewport, but it does not appear in the Outliner. When the layer that contains the prim is printed, the reference is added to the prim.
    Tip: Select Clear All References to remove the references from the Viewport.
  4. The prim you added the reference to receives an arc badge to indicate the newly attained composition arc. See USD Arc badges in the Outliner.


Related Concepts: For more information, see references in the Pixar USD Glossary.