<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macCatalyst: 18.0.0 -",
    "macOS: 15.0.0 -",
    "tvOS: 18.0.0 -",
    "visionOS: 2.0.0 -",
    "watchOS: 11.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/View/labelsVisibility(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI4ViewPAAE16labelsVisibilityyQrAA0E0OF"
  },
  "title" : "labelsVisibility(_:)"
}
-->

# labelsVisibility(_:)

Controls the visibility of labels of any controls contained within this
view.

```
nonisolated func labelsVisibility(_ visibility: Visibility) -> some View
```

## Discussion

Use this modifier when you want to omit a label from one or more
labeled content in your user interface. For example, the first [`Toggle`](/documentation/SwiftUI/Toggle)
in the following example hides its label:

```
VStack {
    Toggle(isOn: $toggle1) {
        Text("Toggle 1")
    }
    .labelsVisibility(.hidden)

    Toggle(isOn: $toggle2) {
        Text("Toggle 2")
    }
}
```

The [`VStack`](/documentation/SwiftUI/VStack) in the example above centers the first toggle’s control
element in the available space, while it centers the second toggle’s
combined label and control element:

![A screenshot showing a view with two toggle controls where one label](images/com.apple.SwiftUI/View-labelsHidden-1@2x.png)

Always provide a label for controls, even when you hide the label,
because SwiftUI uses labels for other purposes, including accessibility.

On iOS, a `Picker` within a `Menu` hides its label by default. You can use
this modifier to explicitly show the label in that context:

```
Menu {
    Picker("Flavor", selection: $selectedFlavor) {
        Text("Chocolate").tag(Flavor.chocolate)
        Text("Vanilla").tag(Flavor.vanilla)
        Text("Strawberry").tag(Flavor.strawberry)
    }
    .labelsVisibility(.visible)
}
```

> Note: This modifier doesn’t work for all labels. It applies to
> ``doc://com.apple.SwiftUI/documentation/SwiftUI/LabeledContent`` elements, including controls like ``doc://com.apple.SwiftUI/documentation/SwiftUI/Picker`` and
> ``doc://com.apple.SwiftUI/documentation/SwiftUI/Toggle``, but not to controls like a bordered button where the label
> is inside the button’s border.

---

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)