Contact Us


Pendo Help CenterInstallation“Test on Device” Troubleshooting

“Test on Device” Troubleshooting

Pairing is being done for:

  1. Preview/Test the guide on the device before publishing it
  2. Collect your application screens, to collect analytics.

If you are having problems pairing your mobile device with the Pendo Console, see the information below for common causes and associated fixes.

Scenario 1: I scan the QR but the page is not loading (blank screen / 404)

This is most likely related to a wrong Scheme ID in the app’s code. Ask your mobile developer to confirm the scheme ID is matching the one located on your App’s Details page. Follow this Pendo guide to get there._

Android: The scheme ID should be located in your AndroidMenifest.xml file;

<activity android:name="" android:launchMode="singleInstance">
    <action android:name="android.intent.action.VIEW"/>
    <category android:name="android.intent.category.DEFAULT"/>
    <category android:name="android.intent.category.BROWSABLE"/>
    <data android:scheme="<FULL_SCHEME_ID>"/>
    <action android:name="<SCHEME_ID>" />
    <category android:name="android.intent.category.DEFAULT" />

iOS: The scheme ID should be inserted both in your project URL Type, and in your openURL function on your appDelegate;

    - (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options;{
    if ([[url scheme] containsString:@"<SCHEME_ID>"]) {
             [[InsertManager sharedManager] initWithUrl:url];
      return YES;
    //  your code here …
    return YES;

Scenario 2: I scan the QR but the page is not loading (blank screen / 404) and the scheme if correct (i checked!)

The pair between Pendo UI and the device is being done via a WebSocket protocol. This can be blocked by your Firewall. Try using a Mobile Network (can be hotspot) instead of WiFi, and try again.

Scenario 3: App opens, but there’s no Pendo Icon.

Confirm Pendo is running by running the app through Xcode or Android Studio and check the logs for: “Pendo Mobile SDK was successfully integrated and connected to the server. App version identified: X.” Or “Insert SDK was successfully integrated and connected to the Insert server. You can start adding insert to your app in the Insert’s web site.”

© 2019 Pendo  |  Terms of Service  |  Privacy Policy