How to add a section header to a table view

Swift version: 5.0

Paul Hudson    @twostraws    June 1st 2019

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!

Tweet

Other people are reading…

• How to find an aspect fit image’s size inside an image view
• How to perform a segue programmatically using performSegue()
• How to check a string is spelled correctly using UITextChecker
• How to move to the next UITextField when the user presses return
• How to give a UINavigationBar a background image: setBackgroundImage()

About the Swift Knowledge Base

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