The Issue Navigator in Xcode - dummies

By Neal Goldstein, Dave Wilson

The Issue navigator is one of the navigators provided by Xcode for your application development. The errors displayed in Apple LLVM compiler’s Live Issues also appear in the Issue navigator, as shown in this figure.

An error message displayed by the Issue navigator.
An error message displayed by the Issue navigator.

To get to the Issue navigator, you select it in the Navigator selector bar.


If, in spite of Live Issues and Fix-it (or any other) warnings, you decide to compile the program, the Issue navigator will automatically launch for you.

The Issue navigator displays the error and warning messages generated in a Project or Workspace and is similar to the other navigators you’ve used so far.

When you select a warning or error in the Issue navigator, an editor displays the item with the issue, and if the error occurs in a source file, the issue message is placed on the line of code with the issue.

Place the pointer over an issue message that ends with an ellipsis (which appears if the pane is too narrow to display the entire message) to get a complete description of the issue.

You can display issues by file or by type using the buttons on the Scope bar, filter the issue list with the Filter bar, and even step through issues using the Issue stepper in the Jump bar. Use the Next and Previous buttons in the Jump bar to jump to the previous and next issues.

You can also change Xcode preferences to have the Issue navigator displayed and a sound played when a build fails.