Add extension apps

Last updated:

To collect usage data and deliver in-app messaging, a Pendo Admin user must create at least one extension app in Pendo. An application in Pendo corresponds to a specific website that you plan to overlay Pendo guides on and gather analytics from.

Adding an extension app turns on the Pendo Launcher for that application and tells Pendo where to track analytics and deliver guides. You must add an extension application in Pendo for every website that you want to run Pendo. 

Create a new extension app

Applications are managed in Settings > Subscription Settings > Applications. From here:

  1. Select + Add Extension App in the top-right corner of the page.
  2. Enter an App Name.
  3. Specify an Extension Platform Type. For information about the options, see Extension platform types in this article.
  4. Add Websites that you want to collect data and deploy guides on. For information on where to find the domain name needed for this step, see Find your domain names in this article.
  5. Select Save to add the application to the list.

After you submit the form, Pendo checks that none of the domains of the new application conflict with other applications. If there’s a conflict, the new extension application doesn’t save.

Extension platform types

During the process of creating a new extension app, you can select the following extension platform types: Salesforce, Workday, Outreach, or Other. Salesforce, Workday, and Outreach receive pre-tagged Pages and Features.

Additionally, these platform types have certain settings enabled by default. You can turn off some of these settings in Pendo when creating a new app or after you've added the app to your subscription. For more information, see Pendo Settings.

Salesforce

When Salesforce is selected as the Extension Platform Type, meaning that Pendo is deployed on Salesforce through the Pendo Launcher, the following specific HTML attributes are also captured. For information on how to edit HTML attributes, see Custom HTML attributes.

  • name
  • data-component-id
  • data-aura-class
  • role
  • label
  • placeholder
  • contains
  • alt-text
  • title
  • aria-*

The following HTML attributes are excluded:

  • Class exclusions: sc-*
  • ID exclusions: content_*

The following settings are on by default:

  • Collect page titles
  • Collect sibling selectors
  • Collect text on Feature clicks

For information about these settings, see Access app details in this article.

Outreach

When Outreach is selected as the Extension Platform Type, meaning that Pendo is deployed on Outreach through the Pendo Launcher, the following specific HTML attributes are also captured. For information on how to edit HTML attributes, see Custom HTML attributes.

  • label
  • data*
  • type

Workday

There aren't any specific HTML attributes captured when Workday is selected as the Extension Platform Type

The following settings are on by default:

  • Collect page titles
  • Collect sibling selectors

For information about these settings, see Access app details in this article.

Find your domain names

You update the list of websites tracked with the domains for your web applications. For example, your Salesforce application might be configured by including the example.force.lightning.com domain. To find your domain name or additional domains that you can use to add your extension app:

  1. Open your application.
  2. Right-click the extension icon (Pendo chevron logo next to the address bar).
  3. Select Show Debug Info.
  4. Select Show Configuration Info.
  5. Copy the value for App Hostname.

Don’t add the following to the domain:

  • The protocol, such as http:// or https://.
  • The path, such as /home or /admin/app/123?tab=details.

If you add these additional details, the new extension application doesn’t save.

Add and edit domains

To add more domains to an existing application or to edit existing domains for an application:

  1. Navigate to Settings > Subscription Settings > Applications.
  2. Select your application from the list. The App Details tab is open by default.
  3. Hover over the Websites row and select the edit icon.
  4. Add more domains or edit existing ones as needed.

Check the app installation

It can take a couple of hours for the extension application to sync with the Pendo Launcher. 

To verify that Pendo is installed on your extension application, open your app in a new tab. The Pendo Launcher chevron logo turns pink if Pendo is capturing data. If the logo isn’t pink when you open your app, select the Pendo logo and then select Show Debug Info > Show Configuration Info > Re-fetch Extension Settings. This manually prompts Pendo to start collecting event data.

The application is considered “installed” when it receives its first event. When Pendo receives the first event for an application, a green Installed label appears in the application’s row of the Applications list in Settings > Subscription Settings.

Open the application from the list to access application settings. The App Details tab is open by default. For a description of this information and settings, see Extension application settings.

Was this article helpful?
0 out of 0 found this helpful