Micro-App Link Format

How to structure your micro-app link to open as desired.

Updated over a week ago

Microapps typically open within the web view of Blink in an iFrame on all devices, allowing users to open links but stay within Blink. This is different than a shortcut in the Hub which always opens in a separate browser window.

We're aware that a number of applications do not support opening in an iFrame on desktop or the web app. Therefore, we developed a prefix URL that will allow the link to open within the app on mobile as well as open in a new browser window on the desktop and web versions.

How to format micro-app URLs in the Hub

For the sake of this example, let's assume that your URL is https://my-wonderful-third-party-app.com?client=mycustomer&weather=beautiful.

This is how the microapp URL will be structured:

  1. Prefix: https://microapps.joinblink.com/utils/x-frame-options-handler?openDesktopInWindow=true&redirect=

  2. The encoded URL for your URL:

    1. To encode a URL use this tool

      1. Paste https://my-wonderful-third-party-app.com?client=mycustomer&weather=beautiful into the top box and click ENCODE

      2. You will end up with the encoded URL: https%3A%2F%2Fmy-wonderful-third-party-app.com%3Fclient%3Dmycustomer%26weather%3Dbeautiful

  3. Join the 2 together to generate your final link: https://microapps.joinblink.com/utils/x-frame-options-handler?openDesktopInWindow=true&redirect=https%3A%2F%2Fmy-wonderful-third-party-app.com%3Fclient%3Dmycustomer%26weather%3Dbeautiful

  4. Add the above as the url for the microapps and you are done 🎉

Did this answer your question?