How Do I Manually Upgrade My Agent?

Last Updated:

What is the Pendo Agent, and what is the “snippet”?

The Pendo Agent is the Javascript code which runs inside of the browser of your web application visitors. A standard Pendo installation loads the Pendo Agent securely and asynchronously from our Cloudfront CDN.

The “Snippet” is the few lines of code found on the Install page of Pendo Install Setup that pulls in the full Agent into your application.


How can I tell if I have the old version or the new version?

You will be able to identify which Pendo snippet and Pendo agent version you are currently using by typing:pendo.VERSIONinto the browser’s console. If it says 2.120.4 or higher, you are on the new version of the snippet and agent. If its version 1.x, then you are on the old version and should upgrade to at least version 2.120.4.


What is the difference between Beta, Stable and Manual?


Beta will automatically update your site to have the most recent version of the Pendo Agent. This is the default and recommended setting for staging servers.

Stable will automatically update your site to a version of the Agent that would normally be one to two weeks behind the Beta version. This is the default and recommended setting for production servers.

Manual will let you pick specific versions of the Agent. This allows you to test a version on staging for example, and then switch over to that fully tested version on production if you so wish.


Where can I subscribe to Agent update notifications?

You can subscribe via RSS feed at Pendo’s Developers site.


How do I move to a new version?

Pendo recommends that you choose to automatically update your Agent version to "Stable" so you can receive the latest updates and critical bug fixes to your agent. In the event that you would like to manually update your Agent version, navigate to your Subscription Settings (as an Pendo Administrator).


If you have multiple web applications setup, choose your desired app and navigate to the "Agent Settings" tab:


This section will show you which Agent version your Staging and Production environment currently use. Select “Manage Staging / Production Settings” and choose the "Manual" radio button and choose your desired version.


What’s your suggested setup for staging and production? (eg. which version should I run)

It depends on your comfort level. You could use “latest” on staging and manually select the most recent tested version that you have tested for production.

What is JSONP and XHR? Which should I use?


Pendo’s current default is JSONP, so you are more than likely using that now. If things are working well for you, stick with JSONP. In general, JSONP is the most widely supported option in terms of browser support. Certainly if your product has older browsers, we’d highly recommend using JSONP.

Some customer’s security teams have issues with JSONP based on their customer’s security requirements. These customers use our XHR transport for guide contents.

Do I have to move to new version? If I don’t, what will happen?

Generally, yes. We will not break anything for users of the old Agent, but you might not be able to use newer features. Customers who choose not to upgrade to the newest version of the Agent will also not receive security updates automatically applied to older versions of the agent.