How to customize a view controller’s back button on a navigation bar: backBarButtonItem
Swift version: 5.10
When you move between view controllers using UINavigationController, it automatically configures a Back button show either “Back” or the title of the previous view controller. That usually works well enough, but if your previous controller has a long title you’ll probably want something custom.
This is where the backBarButtonItem property comes in: set this to an instance of UIBarButtonItem to have UIKit create a back button title of your choosing. You don’t need to provide anything for the target or action parameters of your button, because even with a custom title it’s still just a back button.
Here’s some example code:
navigationItem.backBarButtonItem = UIBarButtonItem(title: "Cancel", style: .plain, target: nil, action: nil)
SPONSORED Alex is the iOS & Mac developer’s ultimate AI assistant. It integrates with Xcode, offering a best-in-class Swift coding agent. Generate modern SwiftUI from images. Fast-apply suggestions from Claude 3.5 Sonnet, o3-mini, and DeepSeek R1. Autofix Swift 6 errors and warnings. And so much more. Start your 7-day free trial today!
Sponsor Hacking with Swift and reach the world's largest Swift community!
Available from iOS 2.0
Similar solutions…
- How to detect when the Back button is tapped
- How to add a bar button to a navigation bar
- SwiftUI tips and tricks
- How to add a button to a navigation bar using storyboards
- How to customize the submit button for TextField, SecureField, and TextEditor
About the Swift Knowledge Base
This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.
