---
title: Configuring the Xcode project window
framework: xcode
role: article
role_heading: Article
path: xcode/configuring-the-xcode-project-window
---

# Configuring the Xcode project window

Customize the Xcode project window and editor area to view and edit project files in a configuration you prefer.

## Overview

Overview The Xcode project window is your primary interface for viewing, editing, and managing all parts of your project. You can configure it to fit your work style and adjust it as you work on different tasks. It’s especially helpful to configure the editor area, where you spend most of your time modifying files. Then use features, like the jump bar, minimap, and tab bar, to navigate quickly around your project files. The main window opens when you create or open a project. To open additional main windows, choose File > New > Window.

The areas of the main window: The toolbar — for building and running your app, viewing the progress of tasks, and configuring the main window — appears at the top of the window. The editor area — for viewing and editing the contents of your project, including code, user interface files, property lists, project settings, and more — appears in the middle of the window. The navigator area — for viewing the parts of your project, including files, symbols, breakpoints, and build information — appears on the right of the editor area. The debug area — for controlling the app runtime during debugging, and for displaying variables, register, and status information — appears below an editor pane. The inspector area — for viewing and editing information about the project, or about the selected object in the navigator or editor area — appears on the right of the editor area. To create an Xcode project, see Creating an Xcode project for an app. note: You can perform most commands described in this document using corresponding menus in the Xcode menu bar. Refer to the menu items for keyboard shortcuts. Show and hide areas of the main window Configure the areas of the main window to focus on your specific task. To show or hide the navigator, inspector, and debug areas: Click the Navigators button on the far left of the toolbar. Click the Inspectors button on the far right of the toolbar. Click the Debug Area button on the right of the debugger toolbar. To switch the navigator, click a navigator in the control above the navigator area. For information about the coding assistant, which appears in the navigator area when you click the coding assistant button, see Writing code with intelligence in Xcode. Navigate the project files You browse the hierarchy of your project files using the Project navigator. Files that you select in the Project navigator open in the editor area. The editor that appears depends on the type of file that you select. For example, if you select a source file, Xcode opens it in the source editor. Then you can use the related menu, arrows, and jump bar that appear in the toolbar above the editor to view or open other files in the editor area. Add multiple editor panes to the editor area Use the controls on the editor toolbar to open multiple files in separate editor panes. To add an editor pane, click the Add button (+) on the far right of the editor toolbar and choose either Editor Pane on Right or Editor Pane Below from the pop-up menu. To close an editor pane, click the X button on the left of the editor toolbar above the pane. To change the focus of the Project navigator and inspector to an editor pane, click it. To temporarily expand or collapse an editor pane, click the Focus/Unfocus this Editor Pane button on the left of the editor toolbar.

Choose editor options and companion views You configure editor panes using controls on the editor toolbar. Use the Adjust Editor Options pop-up menu on the right of the editor toolbar to add options to an editor pane and change the layout of it. You can choose from the following editor options: Compare file changes with previous versions For files under source control, you can compare your changes with a previous commit. To toggle the comparsion view, click the Enable/Disable Code Review button on the left of the editor toolbar. To show the previous commit on the right of an editor, choose Side By Side Comparison from the Adjust Editor Options pop-up menu. To show the changes in an editor, choose Inline Comparison. Then use the controls on the bottom of the comparison view to select versions of the file to compare. Switch quickly between files using the tab bar Use the tab bar that appears above an editor pane to open and pin files that you access frequently. To show the tab bar, choose View > Show Editor Tab Bar. Then add, remove, and pin files: To add a new tab, choose Tab from the Add button pop-up menu to the right of the tab bar, then enter a filename or select a recent file in the Start Page below. To open one or more files in tabs, select the files in the Project navigator, then choose either File > Open in New Tab or File > Open in New Tabs. To pin or unpin a tab, hover over the tab and click the pin icon on the right side of the tab. To close a tab, hover over the tab and click the X on the left side of the tab. For other actions, Control-click the tab and choose an item from the pop-up menu, such as Close Other Tabs.

## See Also

### Navigation

- [Finding and replacing content in a project](xcode/finding-and-replacing-content-in-a-project.md)
