Loading

Lightning Quick Actions Cannot Navigate to External URLs Using the standard__webPage Page Reference Type

Date de publication: May 22, 2026
Description

In Salesforce Lightning, components use the lightning:navigation service's navigate() method with a pageReference object to navigate between pages. For page references of type standard__webPage, the url attribute specifies the external web page URL to open.


In most areas of the Salesforce Lightning app, calling navigate() with a standard__webPage pageReference correctly opens the specified external URL in a new browser tab.


However, when navigate() is called from within a Lightning Quick Action using a standard__webPage pageReference, the component does not open a new browser tab. Instead, Salesforce attempts to navigate to an invalid internal Salesforce URL, and the external page does not load. This is a known gap in the behavior of standard__webPage pageReferences when used specifically within Quick Actions.

Résolution

Alternative 1: Use an Anchor Tag in the Component Markup

Place an HTML anchor tag directly in the Lightning component's markup and set its href attribute to the external URL. This renders as a clickable hyperlink in the Quick Action UI and correctly opens the external page in a new browser tab when the user clicks it.
For example, add an `` element with href set to the target URL and target="_blank" to open in a new tab. This approach does not rely on lightning:navigation and avoids the Quick Action navigation gap entirely.

Alternative 2: Use window.open() in the Component Controller

In the component's JavaScript controller, call window.open() with the external URL as the argument. Invoke this method from an action handler (for example, bound to a button click event). This programmatically opens the external URL in a new browser tab, bypassing the lightning:navigation limitation within Quick Actions.

Numéro d’article de la base de connaissances

000389094

 
Chargement
Salesforce Help | Article