Knowledge base Rise Up

Deep Links: Send Users Directly to a Screen in the Rise Up

  • Updated

 

Overview

A deep link is a standard https link that opens the Rise Up mobile app directly on a specific screen — a course, a resource, a conversation — instead of opening the website. It works exactly like any other web address: no special integration, SDK, or configuration is required.

Deep links are useful whenever you want to send a learner straight to a piece of content from outside the app — for example, in an email campaign, a push notification, an internal communication, or a link shared from another tool.

 

Key elements
  • Platform address: the domain of your own Rise Up platform (for example, https://your-platform.riseup.ai). Every deep link must start with this address.
  • Path: the part of the link after the domain that identifies which screen to open (for example, /Training/view/123).
  • Identifier ({id}): a placeholder in the path that must be replaced with the actual identifier of the item — a course, a session, a resource, and so on.
  • Fallback behaviour: the logic that opens the web platform in a browser when the app isn't installed, instead of the link failing.
  • Custom scheme (riseup://riseup): a link that simply launches the app, without opening any specific screen.

 

I — Build a deep link

A deep link is made of two parts: your platform address, and a path pointing to a specific screen.

  1. Start with your own platform's address, for example https://your-platform.riseup.ai.
  2. Add one of the paths listed in Section III, for example /Training/view/123.
  3. Replace any placeholder in the path ({id}, {stepId}, {sessionId}, {moduleId}) with the identifier of the item you want to open.
  4. Use the finished link exactly as you would any other URL — in an email, a notification, a message, or a call from your own application. No further setup is required.
The link must use your own platform's domain
A deep link only opens the app if it points to your own Rise Up platform address. A link built on any other domain — including another Rise Up platform — will not open the app.

Result:   The link behaves like a normal web address wherever you place it, and directs the app to the target screen when it's tapped.

 

II — What happens when a user taps the link

The link adapts automatically to the user's situation — there's nothing to configure for each scenario.

  • The app is installed — the app opens directly on the target screen.
  • The app is not installed — the link opens the Rise Up web platform in the browser instead, like any normal URL.
  • The user is not logged in — they're asked to log in first, then land on the target screen automatically. Nothing is lost.
Good to know
Because the same link covers all three outcomes, you can safely reuse one deep link across channels (email, notifications, chat) without needing separate versions for app users and web users.

 

III — Available deep links

Add your own platform address in front of any path below, and replace {id} (or the equivalent placeholder) with the identifier of the item.

Trainings

Path Opens
/Training/trainings Courses
/Training/view/{id} Course detail
/Training/view/{id}/step/{stepId} Course, on a specific step
/Training/view/{id}/session/{sessionId} Session
/Training/view/{id}/sessions/{moduleId} The session list of a module
/TrainingBoard/signAttendanceEmail/{sessionId} Attendance sheet signature

Learning paths and objectives

Path Opens
/Training/trainingpaths My learning paths
/Training/trainingpaths/{id} Learning path detail
/Objective/objectives Goals

Catalog

Path Opens
/Catalog Catalog
/Catalog/training/{id} Catalog course detail

Resources

Path Opens
/Catalog/resources Resources
/Catalog/resources/{id} Resource
/Catalog/resources/folder/{id} Resource folder

Community

Path Opens
/Community The community
/Community/talk/{id} Conversation

Certificates

Path Opens
/CertificateAdministration/view/{id} Certificate

 

IV — Open the app directly

If you only need to launch the app without targeting a specific screen, use:

riseup://riseup

This works on both iOS and Android.

The riseup:// scheme isn't limited to launching the app with no target — it also supports any of the paths listed in Section III, the same way a regular deep link does. Simply append the path after riseup://riseup.

Link type Example
Regular deep link https://your-platform.riseup.ai/CertificateAdministration/view/{id}
Custom scheme riseup://riseup/CertificateAdministration/view/{id}
No fallback if the app isn't installed
Unlike a regular https deep link, riseup:// forces the link to open in the app only. If the app isn't installed on the device, nothing happens — there is no fallback to the web platform.

FAQ & Troubleshooting

  • Issue: Tapping the link opens a browser instead of the app.
    Solution: The app is likely not installed on the device — this is expected behaviour, and the link opens the web platform instead. If the app is installed and this still happens, check that the link uses your own platform's domain (Section I) rather than a generic or incorrect address.

    Issue: The link opens the app but not on the expected screen.
    Solution: Check that the path matches one listed in Section III exactly, and that any placeholder ({id}, {stepId}, {sessionId}, {moduleId}) has been replaced with a valid, existing identifier.

    Issue: The link doesn't do anything for a user who isn't logged in.
    Solution: This shouldn't happen — the user should be prompted to log in and then redirected to the target screen automatically. If they land on a generic home screen instead, confirm the link and identifier are still valid.

    Issue: A riseup:// link does nothing when tapped.
    Solution: The app is not installed on the device. Unlike a regular https deep link, riseup:// has no fallback to the web platform — if you need that fallback, use the regular https deep link instead (Section III).
     
  • Do I need any special integration to use deep links?
    — No. A deep link is a normal https link. Use it exactly as you would any other URL, in an email, a notification, or a link from your own application.

    Can I use a deep link on any domain?
    — No. The link must be built on your own Rise Up platform's address. A link on any other domain will not open the app.

    What happens if the app isn't installed?
    — The link opens the Rise Up web platform in the browser instead, just like a normal web address.

    Does the deep link work if the user isn't logged in?
    — Yes. They're asked to log in first, then automatically land on the target screen — nothing is lost.

    Is there a way to just open the app without linking to specific content?
    — Yes, use riseup://riseup. It works on both iOS and Android.
  • Contact Support
     

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request