Pre-filling an instance URL using deep links

Configure mobile experiences > Building and configuring mobile apps > Mobile URLs >

Run a script that includes the deep link generator code to create a URL that can be used to download a ServiceNow® mobile app from the app store and pre-fill with the instance URL upon login.

Role required: admin

The following procedure is an example of how to use the MobileDeepLinkGenerator to create a deep link that pre-fills a ServiceNow instance URL when a user logs in to a Mobile Agent app.

Navigate to All > sys.scripts.do to open the script generator. Paste your script that generates the deep link into the Run script text box. The following deep link script example generates a URL that you can share with users who want their instance information pre-filled for the Mobile Agent app:

var deepLinkGenerator = new global.MobileDeepLinkGenerator(‘Agent’);

var deepLinkGen = deepLinkGenerator.getPrefilllLink(true);

gs.info(link); Note: Run the script on the instance that you want the deep link to pre-fill. For more information about how you can configure different options for deep links, see Mobile deep link structure .

For more information about the options available on the Run script text box, see Using Scripts—Background in the ServiceNow Developer Blog.

After the script runs, copy the URL that it generates and paste it into a communication medium like an email or text message. Users can click on that link to be directed to the app stores where they can download the link and have the instance URL pre-populated on their device to log in. If a user already has the app downloaded, the URL detects it and skips directing them to the app stores.

Parent Topic: <a class="link" href="../../../administer/tablet-mobile-ui/concept/deep-link-mobile.html" title="Mobile deep links are linking formats that direct users to specific content and locations within a mobile app. These links can be placed in email notifications, text messages, push notifications, launcher screens, and input form screens. You can also configure a mobile app login URL for multiple SSO identity providers.">Deep linking for mobile