Source map support

The Bugsnag JavaScript library supports using source maps to reverse JavaScript minification. In order for this to work, Bugsnag needs access to the source map. You can either do this by hosting the source maps or by uploading them to Bugsnag.

Generating source maps

Most modern minification tools support the generation of source maps, so it is easy to add this to your build process:

When generating source maps you normally have the option to include the source content within the source map or leave it in the external source files. If you leave it external Bugsnag will need access to those source files to display the context of the error (without it we will just display the source file and line number in the stacktrace).

Source maps can also be encoded directly into the javascript file rather than linking to a external file, known as inline source maps. This is sometimes used for development purposes or in certain bundling frameworks like Browserify. Bugsnag also supports source maps of this type.

Hosting source maps

If you host the source map Bugsnag can fetch it when an error is received. To achieve this you can include the special sourceMappingURL comment at the end of the JavaScript file or set the X-SourceMap property in the header.

Most minification tools, including UglifyJS 2, will automatically add the sourceMappingURL to your minified JavaScript files.

When generating source maps you’ll usually have the option to include the source content within the source map or leave it in the external source files. If you have not included the source content in the source map we will also attempt to fetch the source files based on the path specified in the source map.

Access through firewall

If your server policy denies access to external IP addresses and websites, you will need to whitelist the IP addresses below. A whitelist provides access to designated IP addresses and sites that would otherwise be prevented by your security policy.


Source map upload

If you don’t want to host your source maps, you can upload them to Bugsnag using one of the following options:

Alternatively, you can interact with our upload API directly.

You can review a list of your uploaded maps, and delete any unneeded ones, within your dashboard: Project Settings -> Uploaded source maps.