Configure Session Replay for React Native

• Latest Dynatrace
• How-to guide
• 8-min read
• Updated on Nov 04, 2026
• Preview

Preview

This page describes how to activate and customize Session Replay for your React Native apps.

Use Session Replay

Session Replay on React Native allows you to capture your customers' interactions with your mobile application and replay each tap, swipe, and screen rotation in a movie-like experience.

Use Session Replay on crashes

You can also use it to get more context for crash analysis in the form of video-like screen recordings that replay the user actions preceding a detected crash.

Prerequisites

Make sure that your system meets the following requirements:

Supported technologies and known limitations

Session Replay is a video-like reconstruction of the user interaction with a mobile application, using captured events and data. Because of this approach, the replayed session can differ from the actual user experience. Known issues:

Activate Session Replay on React Native

Before you start this procedure, make sure you have completed all steps described in Initial setup for React Native frontends to add the @dynatrace/react-native-plugin and generate your configuration.

Mask sensitive data

Data masking levels

Session Replay for React Native comes with three predefined masking levels:

Change masking level

By default, the native agent applies its own masking defaults. To set the masking level from React Native, call SessionReplay.setMaskingConfiguration() with the desired level.

Example 1: Change masking level to Safest

import { SessionReplay, MaskingConfiguration } from '@dynatrace/react-native-session-replay';

SessionReplay.setMaskingConfiguration(MaskingConfiguration.Safest());

Example 2: Change masking level to Safe

SessionReplay.setMaskingConfiguration(MaskingConfiguration.Safe());

Example 3: Change masking level to Custom

SessionReplay.setMaskingConfiguration(MaskingConfiguration.Custom());

Example 4: Change masking level to Custom with no masked view types

SessionReplay.setMaskingConfiguration(
    MaskingConfiguration.Custom().removeAllMaskedViews()
);

Configure custom masking

If you set the data masking level to Custom, you can use additional API methods to control exactly which view types are masked. The Custom level starts with all maskable view types masked. You can then remove or add specific types. You can:

Mask view types

You can enable or disable masking for specific React Native view types using the MaskableView enum. The following view types are supported: TextInput, Text, Image, WebView, and Switch.

import { SessionReplay, MaskingConfiguration, MaskableView } from '@dynatrace/react-native-session-replay';

// Mask everything except images and WebViews
SessionReplay.setMaskingConfiguration(
    MaskingConfiguration.Custom()
        .removeMaskedViews([MaskableView.Image, MaskableView.WebView])
);

// Mask only TextInput fields
SessionReplay.setMaskingConfiguration(
    MaskingConfiguration.Custom()
        .removeAllMaskedViews()
        .addMaskedViews([MaskableView.TextInput])
);

Mask individual components

You can also mask a specific component by wrapping it, regardless of the active masking level.

Use DTMask to force a component to be masked:

import { DTMask } from '@dynatrace/react-native-session-replay';

<DTMask>
    <Text>Sensitive data</Text>
</DTMask>

Use DTWithMask as a higher-order component to create a reusable masked version of any component:

import { TextInput } from 'react-native';
import { DTWithMask } from '@dynatrace/react-native-session-replay';

const MaskedTextInput = DTWithMask(TextInput);

<MaskedTextInput value={secret} />

Enable Session Replay logs

Session Replay logs are part of the general Dynatrace React Native plugin logs. For details, see Debug logging.

Capture custom events

Session Replay automatically records navigation events and list reload events (FlatList, SectionList). However, you can also capture any event that isn't recorded by default. This triggers a manual screenshot capture tagged with the given name.

SessionReplay.trackCustomEvent('User logged in');

Troubleshooting

For setup and configuration issues specific to the Dynatrace React Native plugin, see Troubleshooting.