---
title: RUM Remote Configuration
description: >-
  Configure RUM SDK settings remotely for Browser, iOS, and Android
  applications.
breadcrumbs: Docs > RUM & Session Replay > RUM Remote Configuration
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# RUM Remote Configuration

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com, us2.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ({% placeholder "user-datadog-site-name" /%}).
{% /alert %}

{% /callout %}

## Overview{% #overview %}

As your application evolves, you may need to adjust the data that the RUM SDK collects and its collection frequency. RUM remote configuration lets you update supported Browser, iOS, and Android SDK settings from Datadog without deploying a new version of your application.

{% image
   source="https://docs.dd-static.net/images/real_user_monitoring/remote_configuration/rum_remote_configuration_menu.112f166368d8495196754ae681c1bc41.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/remote_configuration/rum_remote_configuration_menu.112f166368d8495196754ae681c1bc41.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="The SDK configuration page listing available Browser RUM settings for remote configuration." /%}

## Prerequisites{% #prerequisites %}

[Remote configuration](https://docs.datadoghq.com/remote_configuration.md) must be enabled in your organization and requires the following RUM SDK versions:

- Browser SDK version 7.13.0+
- iOS SDK version 3.17.0+
- Android SDK version 3.14.1+

{% alert level="danger" %}
If your network or proxy uses an allowlist, add `*.browser-intake-<DC_REGION>-datadoghq.com` for your application. This entry covers both RUM data intake and the SDK's remote configuration requests, which use the `sdk-configuration.` subdomain. For Browser applications, also add this domain to your Content Security Policy.  If this domain is blocked, the SDK can't retrieve remote settings and continues using its local configuration instead, without any visible error.
{% /alert %}

## How it works{% #how-it-works %}

Each RUM application has a remote configuration ID that the SDK uses to retrieve its remote settings.

When the SDK initializes, it applies cached remote settings. If no cached settings are available, it uses the settings defined in your application. The SDK checks for updates in the background and stores changes for the next initialization. If the check fails, the SDK retains its existing cache or continues to use its local settings. The check does not delay SDK initialization or interrupt RUM event collection.

{% alert level="danger" %}
Published remote settings override the corresponding settings in your application. Settings that you do not enable remotely continue to use their local values. Enable only the settings that you want to manage from Datadog.
{% /alert %}

A remote configuration applies to all users and sessions initialized with its ID. You cannot target individual users or sessions. If you change the ID, the SDK treats it as a new configuration and does not use settings cached under the previous ID.

{% alert level="warning" %}
The SDK retrieves remote configuration settings from a public content delivery network (CDN) endpoint. Do not include secrets or personal information in configuration values.
{% /alert %}

## Permissions{% #permissions %}

Remote configuration uses the same permissions as RUM applications. To enable, edit, or publish a configuration, you need the `RUM Apps Write` permission. For more information, see [Real User Monitoring permissions](https://docs.datadoghq.com/account_management/rbac/permissions.md#real-user-monitoring).

## Setup{% #setup %}

To configure remote settings for an application:

1. Install a supported RUM SDK in a new application, or update the SDK in an existing application.

1. Navigate to RUM > Manage Applications, select an application, and click SDK Configuration.

1. Enable remote configuration to generate a remote configuration ID. **Note**: Datadog saves the configuration as a draft, so its values do not override your existing SDK settings before you publish it.

1. Add the remote configuration ID to your SDK initialization.

   {% tab title="Browser" %}
Add a `remoteConfiguration` object to your existing `datadogRum.init()` call:

   ```javascript
   remoteConfiguration: {
       id: '<REMOTE_CONFIGURATION_ID>',
   },
   ```

      {% /tab %}

   {% tab title="iOS" %}
Add `remoteConfiguration` to your `Datadog.Configuration`:

   ```swift
   remoteConfiguration: .init(id: "<REMOTE_CONFIGURATION_ID>")
   ```

      {% /tab %}

   {% tab title="Android" %}
Call `setRemoteConfigurationId()` on your `Configuration.Builder`:

   ```kotlin
   .setRemoteConfigurationId("<REMOTE_CONFIGURATION_ID>")
   ```

      {% /tab %}

1. Update the settings as described in the Change SDK settings with remote configuration section.

1. Publish the configuration to apply its enabled settings.

## Change SDK settings with remote configuration{% #change-sdk-settings-with-remote-configuration %}

Remote configuration does not override any SDK settings by default. To manage a setting remotely, explicitly enable its override in Datadog, then configure its value. Settings without an enabled override continue to use the values configured in the SDK.

1. Enable the override for a setting that you want to manage remotely. Choose from the settings listed in the Configurable settings section for your platform.
Important alert (level: danger): Certain settings require corresponding module imports in the iOS and Android SDKs. If your application does not import these modules, remote configuration does not work for Session Replay, distributed tracing, or profiling.
1. Configure the setting by selecting a state, changing its sampling rate, or adding data.

1. Save your changes.

## Configurable settings{% #configurable-settings %}

{% tab title="Browser" %}
**Sampling rates**

| UI label                   | Parameter name                |
| -------------------------- | ----------------------------- |
| Session Replay sample rate | `rum.sessionReplaySampleRate` |
| Trace sample rate          | `rum.traceSampleRate`         |
| Profiling sample rate      | `profiling.sampleRate`        |

**Privacy**

| UI label                 | Parameter name                   |
| ------------------------ | -------------------------------- |
| Default privacy level    | `rum.defaultPrivacyLevel`        |
| Privacy for action names | `rum.enablePrivacyForActionName` |

**Event tracking**

| UI label                         | Parameter name                     |
| -------------------------------- | ---------------------------------- |
| Track anonymous users            | `rum.trackAnonymousUser`           |
| Track user interactions          | `rum.trackUserInteractions`        |
| Track resources                  | `rum.trackResources`               |
| Track long tasks                 | `rum.trackLongTasks`               |
| Track sessions across subdomains | `rum.trackSessionAcrossSubdomains` |

**App attributes**

| UI label                 | Parameter name               |
| ------------------------ | ---------------------------- |
| Action name attribute    | `rum.actionNameAttribute`    |
| Trace context injection  | `rum.traceContextInjection`  |
| Allowed tracing URLs     | `rum.allowedTracingUrls`     |
| Allowed tracking origins | `rum.allowedTrackingOrigins` |

{% /tab %}

{% tab title="iOS" %}
**Sampling rates**

| UI label                         | Parameter name                          |
| -------------------------------- | --------------------------------------- |
| Session Replay sample rate       | `sessionReplay.sampleRate`              |
| Continuous profiling sample rate | `profiling.continuousSampleRate`        |
| App launch profiling sample rate | `profiling.applicationLaunchSampleRate` |
| Trace sample rate                | `trace.sampleRate`                      |

**Privacy**

| UI label               | Parameter name                      |
| ---------------------- | ----------------------------------- |
| Text and input privacy | `sessionReplay.textAndInputPrivacy` |
| Image privacy          | `sessionReplay.imagePrivacy`        |
| Touch privacy          | `sessionReplay.touchPrivacy`        |

**Event tracking**

| UI label                    | Parameter name                  |
| --------------------------- | ------------------------------- |
| Track anonymous users       | `rum.trackAnonymousUser`        |
| Track user interactions     | `rum.trackUserInteractions`     |
| Track resources             | `rum.trackResources`            |
| Track background events     | `rum.trackBackgroundEvents`     |
| Track frustration signals   | `rum.trackFrustrations`         |
| Track long tasks            | `rum.longTask.enabled`          |
| Long task threshold         | `rum.longTask.threshold`        |
| Vitals update frequency     | `rum.vitalsUpdateFrequency`     |
| Track slow frames           | `rum.trackSlowFrames`           |
| Track app hangs             | `rum.appHang.enabled`           |
| App hang threshold          | `rum.appHang.threshold`         |
| Track watchdog terminations | `rum.trackWatchdogTerminations` |
| Track memory warnings       | `rum.trackMemoryWarnings`       |

**App attributes**

| UI label                | Parameter name                |
| ----------------------- | ----------------------------- |
| Trace context injection | `trace.traceContextInjection` |
| Allowed tracing URLs    | `trace.tracedHosts`           |

{% /tab %}

{% tab title="Android" %}
**Sampling rates**

| UI label                         | Parameter name                          |
| -------------------------------- | --------------------------------------- |
| Profiling sample rate            | `rum.profilingSampleRate`               |
| Session Replay sample rate       | `sessionReplay.sampleRate`              |
| Continuous profiling sample rate | `profiling.continuousSampleRate`        |
| App launch profiling sample rate | `profiling.applicationLaunchSampleRate` |
| Trace sample rate                | `trace.sampleRate`                      |

**Privacy**

| UI label               | Parameter name                      |
| ---------------------- | ----------------------------------- |
| Text and input privacy | `sessionReplay.textAndInputPrivacy` |
| Image privacy          | `sessionReplay.imagePrivacy`        |
| Touch privacy          | `sessionReplay.touchPrivacy`        |

**Event tracking**

| UI label                  | Parameter name              |
| ------------------------- | --------------------------- |
| Track anonymous users     | `rum.trackAnonymousUser`    |
| Track user interactions   | `rum.trackUserInteractions` |
| Track background events   | `rum.trackBackgroundEvents` |
| Track frustration signals | `rum.trackFrustrations`     |
| Track long tasks          | `rum.longTask.enabled`      |
| Long task threshold       | `rum.longTask.threshold`    |
| Vitals update frequency   | `rum.vitalsUpdateFrequency` |
| Track slow frames         | `rum.trackSlowFrames`       |
| Crash reporting           | `rum.crashReportsEnabled`   |
| Track non-fatal ANRs      | `rum.trackNonFatalAnrs`     |

**App attributes**

| UI label                | Parameter name                |
| ----------------------- | ----------------------------- |
| Trace context injection | `trace.traceContextInjection` |
| Allowed tracing URLs    | `trace.tracedHosts`           |

{% /tab %}

## Further reading{% #further-reading %}

Additional helpful documentation, links, and articles:

- [Real User Monitoring](https://docs.datadoghq.com/real_user_monitoring.md)