<!--
{
  "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/USDPrim/Payload",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "USDKit"
    ],
    "preciseIdentifier" : "s:6USDKit7USDPrimV7PayloadV"
  },
  "title" : "USDPrim.Payload"
}
-->

# USDPrim.Payload

A payload to an external asset.

```
struct Payload
```

## Overview

Payloads are similar to references but designed for deferred loading.
Heavy assets like detailed geometry can be added as payloads and
loaded on demand rather than at composition time.

## Topics

### Initializers

[`init(assetPath: String?, primPath: USDLayer.Path?, layerOffset: USDLayer.TimeOffset)`](/documentation/USDKit/USDPrim/Payload/init(assetPath:primPath:layerOffset:))

Creates a payload.

### Instance Properties

[`var assetPath: String?`](/documentation/USDKit/USDPrim/Payload/assetPath)

The asset path the payload targets, or `nil` if not yet set.

[`var layerOffset: USDLayer.TimeOffset`](/documentation/USDKit/USDPrim/Payload/layerOffset)

Time-axis remap applied to the payload’s animation.

[`var primPath: USDLayer.Path?`](/documentation/USDKit/USDPrim/Payload/primPath)

The target prim path within the referenced asset, or `nil` to use
the asset’s default prim.

## Relationships

### Conforms To

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

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

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

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

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

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

---

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)