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

# USDPrim.VariantSpec

A handle to a single variant option within a variant set.

```
struct VariantSpec
```

## Topics

### Initializers

[`init()`](/documentation/USDKit/USDPrim/VariantSpec/init())

Creates an empty (invalid) variant spec handle.

[`init?(USDLayer.Spec)`](/documentation/USDKit/USDPrim/VariantSpec/init(_:))

Narrows an untyped [`USDLayer.Spec`](/documentation/USDKit/USDLayer/Spec) to a variant spec.

[`init?(owner: USDPrim.VariantSetSpec, name: USDToken)`](/documentation/USDKit/USDPrim/VariantSpec/init(owner:name:))

Creates a new variant spec under the given variant set spec.

### Instance Properties

[`var name: USDToken`](/documentation/USDKit/USDPrim/VariantSpec/name)

The variant’s local name.

[`var owner: USDPrim.VariantSetSpec?`](/documentation/USDKit/USDPrim/VariantSpec/owner)

The owning variant set spec.

[`var primSpec: USDPrim.Spec?`](/documentation/USDKit/USDPrim/VariantSpec/primSpec)

The prim spec this variant authors when selected.

[`var variantSets: [USDToken : USDPrim.VariantSetSpec]`](/documentation/USDKit/USDPrim/VariantSpec/variantSets)

Variant sets defined inside this variant (nested variation).

### Instance Methods

[`func variantNames(USDToken) -> [USDToken]`](/documentation/USDKit/USDPrim/VariantSpec/variantNames(_:))

Returns the variant names available in a nested variant set on
this variant.

## Relationships

### Conforms To

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

[`FieldCollection`](/documentation/USDKit/USDLayer/Spec/FieldCollection)

[`MetadataCollection`](/documentation/USDKit/USDLayer/Spec/MetadataCollection)

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

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

---

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)