A permalink (permanent link) is a persistent identifier in the form of a URL that preserves the exact settings and is intended to remain unchanged, producing a hyperlink that can be used in a variety of content. These guide permalinks can be embedded in various areas, such as emails, knowledge base articles, or help centers.
For the Visual Designer
After creating a guide through the normal guide creation process:
- Set the status to Public and navigate to the Guide Details page.
- In the Guide Details page, select the ellipsis button in the upper right-hand corner to view details.
- Select Copy to copy the "Permalink." The string will look something like
?pendo=123123123123. This string is the unique identifier for the guide you are on.
For the Legacy Designer
After creating a guide through the normal guide creation process, set the status to Public, navigate to the Guide Details page and grab the string next to "Permalink." The string will look something like
?pendo=123123123123. That string is the unique identifier for the guide you are on.
Adding a permalink to a URL
To make use of the permalink, locate the string mentioned above and attach it to the end of the URL that you want to link to, such as:
- Base URL:
- URL with permalink:
This link can then be used wherever you want.
Guide permalinks are subject to standard guide visibility restrictions:
- The visitor is included in the guide segment
- The page matches the location of the first (or only) step of the guide
- The matched element is visible (if applicable)
- The scheduled date is in range (if applicable)
- The guide is set to "Staged" or "Public" status
If the visitor does not meet the criteria required, then the guide will not display even if a permalink URL is used.
If your app drops parameters upon login, and your user is not logged in when they click the link, the guide will not appear as they have not yet been identified by Pendo. In this case, you can ask your users to ensure they are logged in before clicking the link.
If your app has URLs that contain IDs that change from user to user or session to session, then this feature is difficult to use on those URLs as you cannot create a URL that can be shared with all users.
For example, let’s say you have a page for reports that has a URL of:
This example URL included the dynamic user ID of
4820829203. You can create and use a permalink for an individual user to share with them, but cannot create a permalink to share with all of your users in that situation.
For this scenario, we suggest you start a guide at a place in the app that does not have the dynamic URL, such as:
https://app.acme.com/reportListand then use the walkthrough guide with the permalink to walk the user to their own specific report detail page.