NEW: Master Swift design patterns with my latest book! >>

How to add a section header to a table view

Written by Paul Hudson    @twostraws

You can use the built-in iOS table section headers by returning a value from titleForHeaderInSection like this:

override func tableView(_ tableView: UITableView, titleForHeaderInSection section: Int) -> String? {
    return "Section \(section)"
}

If you want to return a custom header view with something more than just some text, you should use viewForHeaderInSection instead, like this:

override func tableView(tableView: UITableView, viewForHeaderInSection section: Int) -> UIView? {
    let vw = UIView()
    vw.backgroundColor = UIColor.red

    return vw
}

Available from iOS 2.0

Did this solution work for you? Please pass it on!

Other people are reading…

About the Swift Knowledge Base

This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.

Hacking with watchOS

Transfer your Swift skills to watchOS the easy way, and learn to build real-world apps in the process!

Click here to visit the Hacking with Swift store >>