Configuration Options
You can customize the behavior of the PRODUCT React Native SDK through configuration options.
Setting Configuration
Pass options when calling initialize():
import Upscope from "@upscopeio/react-native-sdk";
Upscope.initialize({
apiKey: "YOUR_API_KEY",
requireAuthorizationForSession: true,
authorizationPromptTitle: "Screen Sharing Request",
authorizationPromptMessage:
"Allow {%agentName%|Support} to view your screen?",
endOfSessionMessage: "Thanks for using screen sharing!",
translationsYes: "Allow",
translationsNo: "Decline",
});
Configuration Options
Each option resolves in this order: a value you pass here overrides the matching dashboard setting, which overrides the SDK's built-in default (shown in the Default column).
Message Placeholders
The authorizationPromptMessage supports these placeholders:
{%agentName%|fallback}- Agent's name with a fallback if unavailable{%currentDomain%}- App name
Example:
authorizationPromptMessage: '{%agentName%|Our support team} would like to view your screen',
UI Display
| Option | Type | Default | Description |
|---|---|---|---|
showTerminateButton | boolean | (Set through the admin interface) | Show a button in the banner to end the screen sharing session. |
showUpscopeLink | boolean | true | Show the UserView link to the user. Setting this to false only works if whitelabeling is included in your plan. |
endOfSessionMessage | string | (Set through the admin interface) | Message displayed when the session ends. |
stopSessionText | string | (Set through the admin interface) | Custom text for the stop session button. |
Remote Control
| Option | Type | Default | Description |
|---|---|---|---|
allowRemoteClick | boolean | true | Allow agents to remotely tap on the screen. |
allowRemoteScroll | boolean | true | Allow agents to remotely scroll the screen. |
requireControlRequest | boolean | false | Require user approval before agents can use remote input. Resolved from the value set here, else the team's dashboard setting, else false. When it resolves false, remote input is granted without a separate control request — no prompt and no controlRequest event, even with customControlRequestUI enabled. |
controlRequestTitle | string | (Set through the admin interface) | Custom title for the control request prompt. |
controlRequestMessage | string | (Set through the admin interface) | Custom message for the control request prompt. |
customControlRequestUI | boolean | false | Replace the native control request prompt with your own UI. When true, the SDK emits a controlRequest event instead of showing the native prompt; you must subscribe and call respondToControlRequest, otherwise control requests stall. This only changes how the control prompt is presented, not whether it happens: the event fires only when requireControlRequest resolves true. See Listening for Events. |
Lookup Code
| Option | Type | Default | Description |
|---|---|---|---|
enableLookupCodeOnShake | boolean | (Set through the admin interface) | Show lookup code popup when device is shaken. |
lookupCodeKeyTitle | string | (Set through the admin interface) | Custom title for the shake detection alert. |
lookupCodeKeyMessage | string | (Set through the admin interface) | Custom message for shake alert. Supports {%lookupCode%} placeholder. |
Localization Strings
| Option | Type | Description |
|---|---|---|
translationsYes | string | Custom text for "Allow" button in authorization prompt. |
translationsNo | string | Custom text for "Deny" button in authorization prompt. |
translationsOk | string | Custom text for "OK" button. |
Multi-Language Translations
Every text option (titles, messages, and the strings above) also accepts an object keyed by language code instead of a single string. The translation matching the device language is shown, falling back to en if the device language isn't included:
translationsYes: { en: "Yes", it: "Si" },
translationsNo: { en: "No", it: "No" },
All of these can also be configured per language through the dashboard.
Full-Device Screen Sharing (iOS)
| Option | Type | Description |
|---|---|---|
allowFullScreen | boolean | iOS and Android — allow agents to request full device screen sharing during sessions. Also requires the setup described in Full Device Screen Sharing. Default: set through the admin interface. |
disableFullScreenWhenMasked | boolean | When true, full-device sharing is declined while masked content is on screen. Set false to allow it even with masked content present. Default: set through the admin interface. |
customFullDeviceRequestUI | boolean | iOS and Android — gate full-device requests behind your own UI. When true, the SDK emits a fullDeviceRequest event instead of proceeding directly to the system permission prompt; you must subscribe and call respondToFullDeviceRequest, otherwise requests stall. Default false = straight to the system prompt. See Listening for Events. |
System Options
| Option | Type | Description |
|---|---|---|
autoConnect | boolean | Automatically connect on initialization. Default: true (set through the admin interface). |
region | string | Server region for connections. |
onPremiseBaseEndpoint | string | The base endpoint of your on-premise deployment (your instance's BASE_ENDPOINT), e.g. "https://cobrowsing.acmetech.com". When set, the SDK connects to your instance instead of the cloud servers, and region is ignored. |
Full Example
Upscope.initialize({
apiKey: "YOUR_API_KEY",
autoConnect: true,
requireAuthorizationForSession: true,
authorizationPromptTitle: "Screen Share",
authorizationPromptMessage: "{%agentName%|Support} wants to help you",
showTerminateButton: true,
endOfSessionMessage: "Session ended. Thank you!",
stopSessionText: "End Session",
allowRemoteClick: true,
allowRemoteScroll: true,
enableLookupCodeOnShake: true,
lookupCodeKeyTitle: "Your Code",
lookupCodeKeyMessage: "Share this code: {%lookupCode%}",
translationsYes: "Yes, share",
translationsNo: "No thanks",
translationsOk: "Got it",
region: "us-east",
});