Use deep links with the Power Apps mobile app
Deep links let users move from one application to another on computers and mobile devices. Simple examples include a mobile app deep-linking to Facebook to sign in, an email address deep-linking to a mail app to compose a message, or a website deep-linking to an app store to download a related mobile app.
Supported deep links in the Power Apps mobile app
You can open an entityrecord
or an entitylist
view in the Power Apps mobile app by using deep-link URLs from other apps. When you follow the link from an external app, the target element opens in Power Apps mobile
If you're already signed in to your instance in the app, the target record is displayed when you follow the link from an external app. Otherwise, you're prompted to sign in to your instance in the mobile app; after you're signed in, the target element is displayed. You must have the Power Apps mobile app installed on your mobile device to use this feature.
Supported Urls parameters for a model-driven app
Use the following application handler and query string parameters to compose the URL.
Deep links for the Power Apps mobile app should start with the following:
ms-apps://<org-url>_<app-id>?tenantId=<tenant-id>&appType=AppModule&openApp=true&restartApp=true&forceOfflineDataSync=true
Important
The org-url can't contain https://. The following is a example of a model-driven app deeplink:
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=219f9bd4-8c16-4dfa-b87e-f4a33764f1dd
Parameter | Description | Required |
---|---|---|
<targeted-app> |
|
Yes |
<org-url> | Connects to the correct org URL. | Yes |
<app-id> | Opens the correct app module. | Yes |
tenantId=<tenand-id> | Connects to the correct tenant. | Yes |
appType=AppModule | Indicates that the targeted app is a model-driven app. | Yes |
restartApp=true | Restarts the model-driven app. Required to ensure parameters are passed when the app is already open. | No |
forceOfflineDataSync=true | Ensures that data sync is triggered so that all the latest data is available. | No |
If opening an entityrecord
form or creating a new entityrecord
, use the following parameters:
Parameter | Description | Required |
---|---|---|
etn=<entity-logical-name> | Designates which table to go to. | Yes |
pagetype=entityrecord | Indicates that the target is a form. | Yes |
id=<record-id> | Designates which specific record to go to; if left blank, the create form for the table opens. | Yes |
extraqs=<form-id> | Designates which form to open for the entityrecord ; if not specified, the default form opens. The extraqs parameter can also be used to default field values. |
No |
If the link goes to an entitylist
view, add the following parameters:
Parameter | Description | Required |
---|---|---|
etn=<entity-logical-name> | Designates which table to go to. | Yes |
pagetype=entitylist | Indicates that we're going to a view. | Yes |
viewid=<view-id> | Designates which view to open. | No |
Viewtype= <1039 if system view, 4230 if personal view> | Indicates whether the targeted view is a system view or a personal view. | No |
Supported Urls parameters for a canvas app
ms-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true
Parameter | Description | Required |
---|---|---|
<app-id> | Opens the correct app module. | Yes |
tenantId=<tenantId> | Connects to the correct tenant. | Yes |
restartApp=true | Restarts the model-driven app. Required to ensure parameters are passed when the app is already open. | No |
autoLoginUpn=<e-mail> | Autopopulates e-mail and triggers sign-in. | No |
Supported Urls parameters for a wrapped native mobile app
ms-mobile-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true
Parameter | Description | Required |
---|---|---|
<app-id> | Opens the correct app module. | Yes |
tenantId=<tenantId> | Connects to the correct tenant. | Yes |
restartApp=true | Restarts the model-driven app. Required to ensure parameters are passed when the app is already open. | No |
autoLoginUpn=<e-mail> | Autopopulates e-mail and triggers sign-in. | No |
Troubleshooting
Deeplinks may open in your browser depending on the company's organizational policies and the user's device settings. Mobile Device Management (MDM) tools and device operating systems have different options and settings that impact how deeplinks are handled. If deeplinks are opening in a browser instead of directly in Power Apps mobile, make sure your MDM policies and device settings are appropriately configured.
As an example, on some Android devices, go to Settings > Apps > Power Apps > Open by default and add apps.powerapps.com to make deeplinks open directly in Power Apps mobile.