<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/View/upperLimbVisibility(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI4ViewPAAE19upperLimbVisibilityyQrAA0F0OF"
  },
  "title" : "upperLimbVisibility(_:)"
}
-->

# upperLimbVisibility(_:)

Sets the preferred visibility of the user’s upper limbs, while an
[`ImmersiveSpace`](/documentation/SwiftUI/ImmersiveSpace) scene is presented.

```
nonisolated func upperLimbVisibility(_ preferredVisibility: Visibility) -> some View
```

## Parameters

`preferredVisibility`

A value indicating if the upper limbs should be
visible. Use `.automatic` for a system-defined standard behavior,
`.visible` to keep the upper limbs visible, and `.hidden` to hide
the upper limbs.

## Discussion

The system can show the user’s upper limbs during fully immersive
experiences, but you can also hide them, for example, in order to
display virtual hands instead.

Note that this modifier only sets a preference and ultimately the
system will decide if it will honor it or not. The system may be unable
to honor the preference if the immersive space is currently not visible.

---

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)