Instance Method


Pops the top view controller from the navigation stack and updates the display.


- (UIViewController *)popViewControllerAnimated:(BOOL)animated;



Set this value to YES to animate the transition. Pass NO if you are setting up a navigation controller before its view is displayed.

Return Value

The view controller that was popped from the stack.


This method removes the top view controller from the stack and makes the new top of the stack the active view controller. If the view controller at the top of the stack is the root view controller, this method does nothing. In other words, you cannot pop the last item on the stack.

In addition to displaying the view associated with the new view controller at the top of the stack, this method also updates the navigation bar and tool bar accordingly. For information on how the navigation bar is updated, see Updating the Navigation Bar.

See Also

Pushing and Popping Stack Items

- pushViewController:animated:

Pushes a view controller onto the receiver’s stack and updates the display.

- popToRootViewControllerAnimated:

Pops all the view controllers on the stack except the root view controller and updates the display.

- popToViewController:animated:

Pops view controllers until the specified view controller is at the top of the navigation stack.


The gesture recognizer responsible for popping the top view controller off the navigation stack.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software