Enable Expo Crash Reporting and Error Tracking to get comprehensive crash reports and error trends with Real User Monitoring.

With this feature, you can access the following features:

  • Aggregated Expo crash dashboards and attributes
  • Symbolicated iOS and deobfuscated Android crash reports
  • Trend analysis with Expo error tracking

In order to symbolicate your stack traces and deobfuscate Android crashes, upload your .dSYM, Proguard mapping files and source maps to Datadog using the expo-datadog config plugin.

Your crash reports appear in Error Tracking.


Use the expo-datadog package and configuration plugin. For more information, see the Expo and Expo Go documentation.

Add @datadog/datadog-ci as a development dependency. This package contains scripts to upload the source maps. You can install it with NPM:

npm install @datadog/datadog-ci --save-dev

or with Yarn:

yarn add -D @datadog/datadog-ci

Run eas secret:create to set DATADOG_API_KEY to your Datadog API key.

Add git repository data to your mapping files on Expo Application Services (EAS)

If you are using EAS to build your Expo application, set cli.requireCommit to true in your eas.json file to add git repository data to your mapping files.

    "cli": {
        "requireCommit": true

Setting the Datadog site

Run eas secret:create to set DATADOG_SITE to the host of your Datadog site, for example: datadoghq.eu. By default, datadoghq.com is used.

Plugin configuration options

iosDsymstrueEnables the uploading of dSYMS files for the symbolication of native iOS crashes.
iosSourcemapstrueEnables the uploading of JavaScript source maps on iOS builds.
androidSourcemapstrueEnables the uploading of JavaScript source maps on Android builds.
androidProguardMappingFilestrueEnables the uploading of Proguard mapping files to deobfuscate native Android crashes (is only applied if obfuscation is enabled).
datadogGradlePluginVersion"1.+"Version of dd-sdk-android-gradle-plugin used for uploading Proguard mapping files.


Source maps, mapping files, and dSYM files are limited to 500 MB each.

Source maps, mapping files, and dSYM files are limited to 500 MB each.

Disable file uploads

You can disable some files from uploading by setting the iosDsyms, iosSourcemaps, androidProguardMappingFiles, or androidSourcemaps parameters to false.

    "expo": {
        "plugins": [
                    "errorTracking": {
                        "iosDsyms": false

If you want to disable all file uploads, remove expo-datadog from the list of plugins.

Using with Sentry

Both Datadog and Sentry config plugins use regular expressions to modify the “Bundle React Native code and images” iOS build phase to send the sourcemap. This can make your EAS builds fail with a error: Found argument 'datadog-ci' which wasn't expected, or isn't valid in this context error.

To use both plugins, make sure to add the expo-datadog plugin first in order in your app.json file:

"plugins": [

If you are using the expo-dev-client and already have the expo-datadog plugin, revert its changes to the project.pbxproj file before adding sentry-expo and running npx expo prebuild with both plugins.

Further reading