About the Crashes organizer

Use the Crashes organizer to view the crash reports generated for apps that you distribute using TestFlight (iOS, tvOS, watchOS) or distribute through the App Store.

Important: For apps released in the App Store, the user must agree to share crash data with developers. (TestFlight users automatically share crash logs with developers.) Only the Team Agent or Admin role, or an iTunes Connect user can view crash reports.

To view crash reports in the Crashes organizer, choose Window > Organizer and click Crashes. Xcode begins refreshing the crash reports for your apps, including app extensions. Xcode downloads the top crash reports—crash reports with the most number of occurrences on unique devices—that occurred during the past two weeks. However, there may be up to a three-day delay between when you first distribute your app and when crash reports are available in Xcode.

Crashes organizer layout

The Crashes organizer contains these components:

How are crash logs collected and aggregated into crash reports?

Apple provides a service that collects crash logs from users and organizes them into downloadable crash reports. The service that creates the crash reports does the following:

How are crash logs symbolicated?

Symbolication is the process of replacing memory addresses in a crash log with human-readable function names and line numbers. Where symbolication occurs depends on the distribution options you select when you upload your app to iTunes Connect.

Distribution options

Where symbolication occurs

Don’t include bitcode

Upload symbols

The service symbolicates the crash logs.

Include bitcode

Upload symbols

The App Store compiles the bitcode and generates the dSYM files with full symbol names. Then the service symbolicates the crash logs.

Include bitcode

Don’t upload symbols

The App Store compiles the bitcode and generates the dSYM files with obfuscated symbols. When you download the dSYM files, Xcode de-obfuscates the symbols using the .bcsymbolmap files located in the selected archive.

Don’t include bitcode

Don’t upload symbols

Xcode symbolicates crash logs using the dSYM files in your archive or dSYM files it finds on your Mac that are indexed by Spotlight. If Xcode can’t find the dSYM files, the crash log will not be symbolicated. If you can provide the dSYM files later, you can try to symbolicate the crash log again.

See alsoView a crash reportShare user crash data with developersIf no crash reports appear in the Crashes organizerSupported crash reports