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

# tableColumnHeaders(_:)

Controls the visibility of a `Table`’s column header views.

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

## Parameters

`visibility`

A value of `visible` will show table columns,
`hidden` will remove them, and `automatic` will defer to default
behavior.

## Discussion

By default, `Table` will display a global header view with the labels
of each table column. This area is also where users can sort, resize,
and rearrange the columns. For simple cases that don’t require those
features, this header can be hidden.

This will not affect the header of any `Section`s in a table.

```
Table(article.authors) {
    TableColumn("Name", value: \.name)
    TableColumn("Title", value: \.title)
}
.tableColumnHeaders(.hidden)
```

---

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)