Source Maps

Learn how to enable readable stack traces in your Sentry errors.

To enable readable stack traces in your Sentry errors, you need to upload your source maps to Sentry. Learn how to unminify your JavaScript code by watching this video or reading the step-by-step instructions below.

The easiest way to configure uploading source maps is by using the Sentry Wizard:

Copied
npx @sentry/wizard@latest -i sourcemaps

The wizard will guide you through the following steps:

  • Logging into Sentry and selecting a project
  • Installing the necessary Sentry packages
  • Configuring your build tool to generate and upload source maps
  • Configuring your CI to upload source maps

This guide assumes you are using a Browser JavaScript SDK. For instructions on how to set up source maps for React Native, follow the source maps guide for React Native.

If you want to configure source maps upload manually, follow the guide for your bundler or build tool below.

If you're not using one of these tools, we assume you already know how to generate source maps with your toolchain and we recommend you upload them using Sentry CLI.

Though we strongly recommend uploading source maps as part of your build process, for browser applications it's also possible to host your source maps publicly.

Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").