Concept: Mobile Deep Links
A deep link is a URL that takes users from an external source such as an email, website, or text message directly into a mobile app. You can use deep links to direct users to specific screens in the Workday mobile app from:
- Business process configurations
- Custom email templates
- Intranet pages
- QR codes
- Third-party integrations
Examples:
- Your email campaign encourages users to begin open enrollment by tapping a link in their newsletter that takes them straight to theBenefitspage in the app.
- When announcing a policy change, you share a link to the corresponding help article in the app so that users can access the details with a single tap.
When a Workday user taps a link on their supported mobile device, the device’s operating system (OS) determines whether to open the link in a web browser or the Workday mobile app. If the link matches one of Workday's registered URL shapes in the device’s digital registry, the app opens.
If the link doesn’t match the URL shape, the OS opens the link in the mobile browser, potentially requiring the user to log in to Workday and then navigate to their destination. For users without the Workday mobile app installed, the OS also falls back to the mobile browser, but doesn’t force them to install the Workday app to proceed.
Supported URL Pattern
To ensure that deep link URLs open in the Workday mobile app instead of a browser, you must format them using this URL pattern for iOS and Android in all customer tenants:
https://<subdomain>.<workday-host>/<tenant>/email-universal/task/<task-id>
To create a valid deep link, you must:
- Include the/email-universal/segment, which indicates that the URL is intended for use in the mobile app.
- Use one of these domains for the<workday-host>segment:DomainEnvironment<subdomain>.myworkday.com (most common)Production<subdomain>.workday.comProduction<subdomain>.workday.netInternal or Staging
- Ensure that the<task-id>segment represents a task that is both mobile supported and enabled. See the Mobile-Supported Tasks section below for guidance.
Example: Deep Link URL to the Home Page
https://acme.myworkday.com/acmesupply/email-universal/task/2997$6670.htmld
- <subdomain>: acme
- <workday-host>: myworkday.com
- <tenant>: acmesupply
- <task-ID>: 2997$6670
Mobile-Supported Tasks
You must verify that Workday supports any task you’re deep-linking to in the mobile app. When the app doesn’t support the task or the user doesn’t have the necessary access to it, Workday displays an error or redirects them to the mobile browser.
To determine whether the Workday mobile app supports a task:
- Access theList Tasks Available On Mobilereport, which lists task IDs for mobile-supported tasks that are associated with business process events. If the task isn’t part of a business process, it won’t appear on this report even though the mobile app may still support it.
- If you don’t see the task in this report, log in to Workday on a mobile device (the app or a mobile browser) and try to access the task to verify that it’s available and behaves as expected.
Unsupported URL Patterns
Any link that doesn’t include the /email-universal/
segment won’t load in the Workday mobile app.
Workday doesn’t support deep links for these common URL patterns:
Component | Description |
|---|---|
/d/ | Part of the generic desktop URL path that Workday uses for every task, which includes many tasks that aren't supported in the mobile app. |
Feature-specific paths | Some Workday features use their own URL path conventions (example: /learning/ ). Like /d/, these are web-oriented paths not registered as mobile deep link entry points and will open in the mobile browser. |
https://workdayapp.page.link | This URL pattern previously powered a class of cross-platform Workday deep links via Google's since-retired Firebase Dynamic Links service. See this Community post for more information. |
workday://
workday+https:// | Although we discourage their regular use for customer tenants, some internal Workday environments may use these private URL schemes without browser fallback.
If the user taps one of these links on a device that doesn't have the Workday app installed, the content won’t open in the browser. Instead, depending on where they tapped from, the user may see an error message or be redirected to an unexpected URL. |