Introduction

Going back to a previous screen in UIKit depends on how the current view controller was shown. If it was pushed onto a UINavigationController, you usually pop it. If it was presented modally, you dismiss it. The most important part is understanding your navigation style before writing the code.

Go Back in a Navigation Controller

If the current view controller was pushed onto a navigation stack, use popViewController.

1import UIKit
2
3final class DetailsViewController: UIViewController {
4    @IBAction func goBackTapped(_ sender: UIButton) {
5        navigationController?.popViewController(animated: true)
6    }
7}

This removes the current view controller from the stack and reveals the previous one.

That is the standard answer for push-based navigation such as:

• tapping from a list into a detail page
• using a show segue inside a navigation controller
• programmatically pushing with pushViewController

Dismiss a Modally Presented View Controller

If the screen was presented with present, do not use popViewController. Dismiss it instead.

1import UIKit
2
3final class SettingsViewController: UIViewController {
4    @IBAction func closeTapped(_ sender: UIButton) {
5        dismiss(animated: true)
6    }
7}

This is the right choice for sheets, full-screen modals, and other presentation styles that are not part of a navigation stack.

Pop to a Specific Earlier Screen

Sometimes "go back" does not mean only one level. You may want to jump back to a known controller already in the stack.

1if let controllers = navigationController?.viewControllers {
2    for controller in controllers {
3        if let target = controller as? HomeViewController {
4            navigationController?.popToViewController(target, animated: true)
5            break
6        }
7    }
8}

This is useful in flows such as checkout or onboarding when you want to skip several intermediate screens.

If you want to return all the way to the root:

navigationController?.popToRootViewController(animated: true)

Decide Based on Presentation Style

A simple rule helps:

• pushed with navigation controller: pop
• presented modally: dismiss

If you are not sure which one applies, inspect how the view controller was created. The same screen can behave differently depending on how it entered the hierarchy.

You can even write fallback logic:

1if let navigationController = navigationController {
2    navigationController.popViewController(animated: true)
3} else {
4    dismiss(animated: true)
5}

That is convenient for reusable screens that may appear in more than one navigation context.

Storyboards and Buttons

If the action is wired from Interface Builder, the code is the same. The only difference is where the @IBAction comes from.

@IBAction func backButtonPressed(_ sender: Any) {
    navigationController?.popViewController(animated: true)
}

You can connect this to a custom button or bar button item in the storyboard.

If the navigation bar already shows the default back button, you often do not need extra code at all. Programmatic back navigation is mostly for custom flows or custom controls.

Common Pitfalls

The most common mistake is calling popViewController on a modally presented screen. Nothing happens because there is no navigation stack to pop from.

Another issue is assuming navigationController is always present. It is optional, and it will be nil when the controller is not embedded in a navigation controller.

Developers also sometimes bypass the expected back behavior by creating a brand new previous screen instead of returning to the existing one. That usually breaks navigation state and duplicates controllers unnecessarily.

Finally, be careful when jumping to a specific controller in the stack. If it is not there, popToViewController cannot do anything.

Summary

• Use navigationController?.popViewController(animated:) for push-based navigation.
• Use dismiss(animated:) for modally presented screens.
• Use popToViewController or popToRootViewController when you need to jump back more than one level.
• Check whether the controller is embedded in a navigation controller before popping.
• Choose the back-navigation API based on how the screen was originally presented.