newrelic.setPageViewName(string $name[, string $host])
Groups page views to help URL structure or to capture the URL's routing information.
Agent version nr-593 or higher.
Customized page names can help you more effectively group your page views if your URL structure does not provide useful groupings or if the browser agent doesn't capture the part of the URL where routing information is stored. When querying the
PageView event, the custom name will be exposed as the
browserTransactionName attribute. The custom name will also be visible in the browser monitoring UI.
To use a customized page view name instead of the page URL, format the name as a slash-delimited string. Make this call before the
window load event fires in order for it to appear correctly.
This API call applies to data in standard page views in browser and the
PageView event. To set a custom name for SPA page views and the
BrowserInteraction event, see SPA: setName. Using both calls together is recommended.
Required. The page name you want to use. Use alphanumeric characters.
Optional. Default is
To further group these custom transactions, provide a custom
newrelic.setPageViewName('/login')// Ornewrelic.setPageViewName('/login', 'https://www.myapp.com')
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's data security and licenses documentation.