Navigation Actions in the Salesforce Mobile App

Use these supported programmatic navigation actions in your Lightning web components intended for use in Salesforce Mobile App Plus.

Each Salesforce mobile app implements support for the navigation service independently, which results in some differences in available navigation actions. The following PageReference types are supported by the LWC navigation service when used in the Salesforce Mobile App Plus mobile app.

standard__quickAction
standard__webPage

You can implement a surprising number of different navigation actions with these PageReference types. The following are examples of navigation actions, and the PageReference used to implement them.

Navigate to a Quick Action

Create a navigation action that opens an LWC-based quick action.

1{
2    "type": "standard__quickAction",
3    "attributes": {
4        "actionName": `objectApiName.actionApiName` },
5        "state": {
6            "recordId": "<recordId>",
7            "objectApiName": "<objectApiName>"
8    }
9}

objectApiName.actionApiName represents the name of the quick action (actionApiName), and the sObject that it’s defined on (objectApiName). The state object provides a way to pass data into the target component. In this example, recordID and objectApiName are public properties defined in the objectApiName.actionApiName quick action’s JavaScript code.

Open Salesforce Mobile App via Deep Link

Create a navigation action that leaves Mobile App Plus, and opens a specific page in the Salesforce mobile app.

1{
2    "type": "standard__webPage",
3    "attributes": {
4        "url": "salesforce1://sObject/001D000000Jwj9v/view"
5    }
6}

There’s a wide range of targets available for deep linking into the Salesforce Mobile app. See Configure Deep Linking for the Salesforce Mobile App in the Salesforce Help for available URL formats.

Open the Field Service Mobile App via Deep Link

Create a navigation action that leaves Offline App Plus, and opens a specific page in the Field Service mobile app.

1{
2    "type": "standard__webPage",
3    "attributes": {
4        "url": `com.salesforce.fieldservice://v1/sObject/${this.recordId}/details`
5    }
6}

There’s a wide range of targets available for deep linking into the Field Service mobile app. See Deep Linking Schema for the Field Service Mobile App in the Field Service Developer Guide for available URL formats.

Open Web Page

Create a navigation action that opens a screen that displays an external web page.

1{
2    "type": "standard__webPage",
3    "attributes": {
4        "url": "https://salesforce.com"
5    }
6}

Open Email App

Create a navigation action that opens the device’s native email client and pre-fills the addressee and subject lines.

1{
2    "type": "standard__webPage",
3    "attributes": {
4        "url": "mailto:help@AcmeSupport.com?subject=Help with Asset"
5    }
6}

Open Phone App

Create a navigation action that opens the device’s native phone app, and dials a phone number.

1{
2    "type": "standard__webPage",
3    "attributes": {
4        "url": "tel:123-456-7890"
5    }
6}

Open Message App

Create a navigation action that opens the device’s native SMS or message app, and pre-fills the recipient phone number.

1{
2    "type": "standard__webPage",
3    "attributes": {
4        "url": "sms:12345678"
5    }
6}

Mobile and Offline Developer Guide