Symbol Files

Symbol files are critical to getting useful data from your crashes. Windows, Breakpad, Crashpad, MacOS, Xbox, PlayStation, Nintendo, and some JavaScript applications require uploading symbol files to generate call stacks that contain function names and line numbers. The symbol upload process can be automated as part of your build. Many of our SDKs require symbols, which can be uploaded and managed via the Versions page.

For additional information regarding Symbol files, please visit the documentation specific to your application's platform.

What are Symbols?

Symbols are files containing information to map the crash report's call stack to file names and line numbers in source code.

Using Symbols

Windows C++ and .NET symbol files have .exe, .pdb, and .dll extensions.

For Crashpad applications, symbols files contain .sym extensions.

For macOS applications, symbols files end with a .dSYM extension.

For TypeScript and JavaScript applications, symbols are files with a .js.map extension.

Symbol files can be uploaded via symbol-upload. Additionally, Crashpad .sym files can be generated automatically by invoking symbol-upload with the -m argument.

BugSplat Versions Page

Additional Resources

Source MapsHow to Manually Upload SymbolsWorking with Symbol Files in Windows Environments