<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -",
    "macOS: 27.0.0 -",
    "tvOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "USDKit",
  "identifier" : "/documentation/USDKit/USDStage/Object",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "USDKit"
    ],
    "preciseIdentifier" : "s:6USDKit8USDStageV6ObjectV"
  },
  "title" : "USDStage.Object"
}
-->

# USDStage.Object

```
struct Object
```

## Topics

### Protocols

[`protocol MetadataCollection`](/documentation/USDKit/USDStage/Object/MetadataCollection)

A scene graph object that possesses metadata.

[`protocol MetadataValue`](/documentation/USDKit/USDStage/Object/MetadataValue)

A value that can be stored as metadata in a Universal Scene Description file.

### Initializers

[`init()`](/documentation/USDKit/USDStage/Object/init())

An invalid object handle.

[`init(USDPrim)`](/documentation/USDKit/USDStage/Object/init(_:)-421oz)

[`init(USDPrim.Attribute)`](/documentation/USDKit/USDStage/Object/init(_:)-44tvz)

Casts an attribute handle to an object handle.

[`init(USDPrim.Relationship)`](/documentation/USDKit/USDStage/Object/init(_:)-64kbz)

[`init(USDPrim.Property)`](/documentation/USDKit/USDStage/Object/init(_:)-9xizj)

Casts a property handle to an object handle.

### Instance Properties

[`var isValid: Bool`](/documentation/USDKit/USDStage/Object/isValid)

A Boolean value indicating whether this object is valid.

[`var name: USDToken`](/documentation/USDKit/USDStage/Object/name)

The name of this scene graph object.

[`var path: USDLayer.Path`](/documentation/USDKit/USDStage/Object/path)

The complete scene path to this object, relative to its stage.

[`var prim: USDPrim`](/documentation/USDKit/USDStage/Object/prim)

The nearest prim that contains this object.

[`var primPath: USDLayer.Path`](/documentation/USDKit/USDStage/Object/primPath)

The complete path to this prim, or to the nearest prim that contains this object.

[`var stage: USDStage`](/documentation/USDKit/USDStage/Object/stage)

The stage that owns this object.

### Default Implementations

[CustomStringConvertible Implementations](/documentation/USDKit/USDStage/Object/CustomStringConvertible-Implementations)

## Relationships

### Conforms To

[`MetadataCollection`](/documentation/USDKit/USDStage/Object/MetadataCollection)

[`Equatable`](/documentation/Swift/Equatable)

[`Escapable`](/documentation/Swift/Escapable)

[`Copyable`](/documentation/Swift/Copyable)

[`Hashable`](/documentation/Swift/Hashable)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)