HomeDocumentationAPI Reference
Getting StartedAPI ReferenceBug ReportingCrash ReportingAPMHelp Center

Repro Steps for React Native

Learn more about the steps your user has taken until the bug or crash was reported on your React Native apps.

Repro Steps show you all of the interactions a user makes with your app up until a bug or crash is reported, grouped by app view. For each view that a user visits, all of the steps that they commit within those views are captured and displayed as a log, grouped by view.


An example of Repro Steps in the Instabug dashboard.

Setting Up Repro Steps

Repro steps are enabled by default and support the 2 most popular React Native navigation libraries.



You'll need to set the onStateChange to Instabug.onStateChange in your NavigationContainer as follows:

  onStateChange={  Instabug.onStateChange  }  />

v4 or Earlier

You'll need to set the onNavigationStateChange to Instabug.onNavigationStateChange in your app wrapper as follows:

export default () => (
    onNavigationStateChange={ Instabug.onNavigationStateChange } />


You'll need to register the Instabug.componentDidAppearListener listener using the following code:


Manual Navigation Recording

Alternatively, if you'd like to manually record screen changes, you can use the API below:


Logged Data

Captured Events

UI Interactions

For the following gestures, only the gesture is logged and displayed:

  • Swipe
  • Scroll
  • Pinch
  • Tap
  • Force touch
  • Double tap
  • Enabling/disabling a switch
  • Changing the value of a slider
  • Editing a text field.

Lifecycle Events

Whenever one of the following lifecycle events occurs, it will be captured and shown on the timeline:

  • Application is moved to the background
  • Application is moved to the foreground
  • Application becomes active
  • Application becomes inactive
  • Memory warning

Extra Details

Depending on the event, you'll find further details displayed as part of the log statement.

  • Tap, double tap, and force touch: the SDK always tries to first capture the text rendered inside the UI that the user is interacting with, then we fall back to capturing the icon only with the buttons and navigation items, then, we fall back to the accessibility labels.
  • Switch: both the accessibility label as well as whether the user enabled or disabled the switch are logged.
  • Slider: both the accessibility label as well as the value that the user moves the slider to it are captured.
  • Text fields: first, the SDK tried to capture the placeholder, then we fall back to the accessibility label.


Here are some examples of how steps look like:

  • Tapped on the button "Send"
  • Double tapped on UI that contains "Instructions"
  • Started editing “Password“
  • Enabled the switch “Push Notifications“
  • Moved the slider “Text Size“ to 10%
  • App went to the background
  • App became active
  • Memory warning

User Privacy


A disclaimer will be shown at the bottom of the report. It helps your users view all the screenshots taken for the Repro Steps before sending a report and can delete them as well.

Private Views

You can mark any view containing sensitive information, such as payment details, as private using Instabug. A private view will automatically appear with a black overlay in any screenshot. To designate a view as private, use the following property in JSX:

<Text ref={c => this.textView = c} style={styles.welcome}>This is a private view!</Text>

To make the view private, use the following API:



Views that are only used for layout or otherwise don't draw anything may be automatically removed from the native hierarchy as an optimization. Therefore, calling Instabug.addPrivateView on a view that has no style or is redundant won’t mask it, as the view will be optimized out.

Disabling and Enabling

Repro Steps is by default enabled with screenshots for bug reporting and enabled without screenshots for crash reporting.

import Instabug, { ReproStepsMode } from 'instabug-reactnative';

  bug: ReproStepsMode.enabled,
  crash: ReproStepsMode.enabled,

To configure Repro Steps, use the Instabug.setReproStepsConfig() method. You can configure the desired mode for bug reports and crash reports separately using the bug and crash parameters or configure both using all parameters, which overrides both bug and crash.

  all: ReproStepsMode.enabled,

Here are the possible arguments.

//Enable Repro Steps with screenshots
//Enable Repro Steps without screenshots
//Disable Repro Steps


Instabug.setReproStepsConfig({all: ReproStepsMode.enabled});


Instabug.setReproStepsConfig({bug: ReproStepsMode.enabled, crash: ReproStepsMode.enabled});
Enable with screenshot for both Bug Reporting and Crash Reporting.

When the all value is present, it overrides both the bug and crash arguments.
Instabug.setReproStepsConfig({crash: ReproStepsMode.enabledWithNoScreenshots});Enable with no screenshots for Crash Reporting. (Bug Reporting still retains the default value enabled)
Instabug.setReproStepsConfig({bug: ReproStepsMode.enabled});Enable with screenshot for Bug Reporting. (Crash Reporting still retains the default value enabled without screenshots)
Instabug.setReproStepsConfig({all: ReproStepsMode.disabled});


Instabug.setReproStepsConfig({bug: ReproStepsMode.disabled, crash: ReproStepsMode.disabled});
Completely disable for both Bug Reporting and Crash Reporting.


Screenshots are always disabled with Crash Reporting.

For Crash Reporting, the screenshots are always disabled as the data is silently collected without any interaction from the user. This decision is part of our ongoing commitment to end-users' privacy.