<!--
{
  "documentType" : "article",
  "framework" : "Xcode",
  "identifier" : "/documentation/Xcode/configuring-the-xcode-project-window",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "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

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.

![An Xcode screenshot of the project editor showing the location of the main window areas: the toolbar at the top, navigator area on the far left, editor area in the middle, and inspector area on the far right. In the editor area, the source editor is on the left, the canvas is on the right, and the debugger is below.](images/com.apple.Xcode/xcode-window-areas@2x.png)

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](/documentation/Xcode/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](/documentation/Xcode/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.

![An Xcode screenshot of the project editor with the Project navigator on the left and a source file selected. The editor area on the right shows the comparison view above and two source editor panes side-by-side below with the Canvas menu item selected from the Adjust Editor Options pop-up menu.](images/com.apple.Xcode/configuring-editor-area@2x.png)

### 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:

- Show Editor Only: Hides a companion canvas or assistant to show only the editor.
- Canvas: Shows a canvas that displays results of preview and playground macros in a source file.
- Assistant: Shows an assistant that displays information about the file.
- Layout: Changes the location of an editor relative to a companion canvas or assistant.
- Inline Comparison: Shows changes to a file under source control in an editor when you enable code review.
- Side By Side Comparison: Shows changes to a file under source control in a separate view next to an editor when you enable code review.
- Minimap: Provides a miniaturized version of a file that you use to navigate around the file.
- Authors: Shows the commit history of a file under source control.
- Code Coverage: Displays statistics about a source file after you run tests, such as portions of your code not tested.
- Invisibles: Shows invisible characters in a file.
- Wrap Line: Wraps lines that exceed the width of the editor.

### 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.

![An Xcode screenshot of the project editor with the Project navigator on the left and a source file selected. The editor area is on the right with the source editor on its right and the canvas on its left. The tab bar appears above the editor toolbar with a tab contextual pop-up menu showing the Close Other Tabs menu item selected.](images/com.apple.Xcode/using-editor-tabs@2x.png)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)