URLs for Page tagging

Overlapping tagging rules

User interactions with your application are captured as raw events and sent to Pendo through the Pendo Web SDK. Pendo processes these events and matches them against the rules you create for tagging Pages. Only events that you've defined in your tagging rule for a Page are pulled into the analytics for that Page. When you segment or filter based on a named Page in Pendo, you're searching every raw event and only pulling in events that match the rules that you've defined for that Page. This has implications for how overlapping rules impact your analytics.

A Pendo Page can be made up of several rules, as well as rules that include wildcards to capture multiple URLs. This allows you to refine the search of raw events to define what counts toward a Page view, such as variations of the same URL. It also allows you to create a Page that represents views of an entire application or area of your application, which can be helpful for segments, reports, and guide targeting. For example, you might want to capture all the individual contact profiles under a single Page in Pendo called "All contacts".

You can capture both a group of URLs in a single Page and individual URLs belonging to that group in other individual Pages. This gives you flexibility in your analytics to see the data that's most useful to you. If an event satisfies the criteria defined by the tagging rules for more than one tagged Page, it's pulled into the metrics for each of those Pages. 

For example, as well as a single Page that captures a group of URLs called "All contacts" in Pendo, you might want to capture the individual contact profiles as separate Pages in Pendo. Overlapping or duplicate tagging rules between the "All contacts" Page and the individual contact profile Pages don't compete with each other. Rather, Pages that have overlapping or duplicate tagging rules count the same event against each relevant Page with a matching tag.

Parameterized URLs 

Pendo allows you to parameterize a URL. Parameters in Pendo Pages are specific query parameters or path variables that help you identify and track different variations of a URL or page within your application. These parameters help you gain a deeper understanding of user interactions with dynamic content or pages that share a common structure but differ in specific attributes.

This functions similarly to a wildcard *, except that it nests the different values under the Page you created and is useful for creating Page rules across a countable variety of URLs with a single entry.

For example, if you have the following three URLs that carry similar content or that you'd like to view together:

https://www.pendo.io/features/foo/

https://www.pendo.io/features/bar/

https://www.pendo.io/features/ipsum/

You could use the following Page rule to capture all three:

//*/features/*parameter*/

These appear inside your subscription under your Page rule, showing each parameter value and its number of Page views.

You can also store a single query parameter as a Page parameter using the same syntax described earlier, for example: //*/?first=*parameter*.

Parameter values aren't case-sensitive, and only the top 100 parameters are displayed when viewing an individual Page tag in the Pendo UI. To view more Page parameters in the Pendo UI, create a Data Explorer report and group by Page parameter.  You can also use the API described in Analyze Page parameters with the API.

Analyze Page parameters in reports and segments

When a Page rule includes parameters, Pendo automatically captures these values as custom event properties. This means you can use Page parameter values outside of the Page details view, including in segments and Data Explorer.

Page parameters appear in the Event breakdown table for the Page and can also be used as filters or grouping options in reports. This allows you to analyze behavior across dynamic or personalized Page variations without tagging each version separately.

For example, if your Page rule is defined as //*/portfolio/*parameter*/, you can filter or group report data by individual portfolio IDs to compare engagement across pages like /portfolio/12345 and /portfolio/67890.

Note: Only parameters collected through Page rules appear as event properties. If a parameter isn’t captured in your Page tagging rule, it won’t display as an option in the segment builder or report filters.

URLs with UTM parameters

UTMs are tags added to the end of a URL to provide context on the source of the link. For example, a link embedded in an email might look like this: www.example.com?utm_source=email. In this case, utm_source tells you the visitor came from an email link.

As of May 1, 2025, Pendo automatically captures UTM parameters as session properties for all subscriptions using web SDK version 2.272.0 or later. These values are available in reporting tools like web analytics without any tagging required.

However, you might still want to tag UTM-specific Pages if you need to:

• Track activity for individual UTM values outside of web analytics (for example, in funnels or paths).
• View top UTM parameter values for a specific Page.
• Capture other marketing parameters not using standard UTM names.

Session properties are available to all subscriptions as of May 1, 2025.

If you decide to tag UTM parameters as Pages, we recommend one of the following approaches:

• Tag each URL individually. Create one Page for every UTM parameter value you care about.
• Use parameterized URLs. Create a single Page definition that captures all UTM values using Pendo's parameter functionality.

Option 1. Create a Page for each UTM parameter value

If you have a limited number of UTM parameter values or are only interested in a select few, you can tag each value as an individual Page in Pendo. Because each UTM parameter value has its own page in Pendo, you can view usage analytics for each UTM source individually. You can also explore each value throughout the Pendo UI, including in Data Explorer, funnel, and path reports.

For example, to view activity for the three utm_source values below, you can create one Page in Pendo for each parameter value.

Option 2. Create a Page that captures multiple UTM parameter values

If there are many possible values for the UTM parameter, you can use Pendo’s parameter functionality to create one rule that captures all possible values in a single Page in Pendo.

For example, you can use a single rule with a parameter to create a Page that would allow you to view activity for all three utm_source values below. These values appear under your Top Parameters for that Page, aong with the number of views for each value on the Parameters table. 

Supported URLS

The table that follows lists supported standard URL syntax and examples.

Pendo understands the difference between https://domain.com/#page1 and https://domain.com/#page2. The Page rule, https://*, will match with both URLs. If your URLs are structured this way and you'd like to have a Page rule that only corresponds with https://domain.com, review the Location API documentation.