Source Maps
Upload your source maps to Sentry to enable readable stack traces in your errors.
To enable readable stack traces in your Sentry errors, you need to upload your source maps to Sentry.
The easiest way to configure uploading source maps is by using the Sentry Wizard.
See how uploading source maps lets you see the exact line of code that caused an error:
The easiest way to configure uploading source maps is by using the Sentry Wizard:
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
Note: Source maps are only generated and uploaded during production builds. Development builds typically do not generate source maps for upload.
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 to upload manually, follow the guide for your bundler or build tool below.
If you used Create React App to set up your React application see our Create React App guide to upload source maps.
If you're using one of webpack, Vite, Rollup, or Esbuild, use the corresponding Sentry plugin instead (see section "Sentry Bundler Support").
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.
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").