This documentation supports the 22.1 version of BMC Helix Digital Workplace Basic and BMC Helix Digital Workplace Advanced. Icons distinguish capabilities available only for the Advanced and External license levels. For more information, see License types and features.

Defining navigation through links in pages

Links in the workplace pages guide your users to specific content. Add links to help your users navigate to pages, catalog services, and content within or outside your organization. Links can be images, buttons, or clickable text.  

The following image is a visual guide to creating a page and making it available to your end users, and shows the current step that you are on:

Step 5 in page creation process - adding links  

Links are of the following types:

  • On-click links—Link is added on content blocks, images, and buttons.  
  • Inline links—Link is added in a text block with contextually relevant content.
    Add contextually relevant links to guide your end users to other pages and useful information. Inline links enable you to add meaningful text and create links that correctly describe the page you direct your end users to. 

The following table lists the types of links and their behavior:

Location of linkInternal links open in External links open in
Inline in a text block Current tabNew tab

On-click link on content blocks, images, and buttons



Relative links are links to BMC Helix Digital Workplace core application pages, studio pages, external pages, catalog services, knowledge articles, and other pages internal to the organization. You can add them as inline links or as on-click links.

Supported URI schemes

By default, studio pages support the following URI schemes:

httpHTTP resources
httpsHTTP connections secured
ftpFTP resources
sftpSFTP file transfers
ftpsFTP over SSL
geoGeographic locations
mailtoSMTP email addresses
mmsWindows streaming media
newsUsenet news groups or articles
nntpUsenet news using NNTP
sipUsed with Session Initiation Protocol
smsShort message service
smstoShort message service to
sshSSH connections
telFor telephone numbers
webcalCalendars in iCalendar


Wireless Telephony Application Interface

xmppExtensible Messaging and Presence Protocol

To modify the list of supported URI schemes

You can modify the list of supported URI schemes based on your security concerns.

  1. In the BMC Helix Digital Workplace Admin console, navigate to the Configuration tab.
  2. In the left pane, click Attachments & Links.
  3. On the Links tab, edit the list of supported URI schemes.
  4. Click Save.
  5. (Optional) If you want to restore the default supported URI schemes list, select Reset to default > Save.

Use Markdown to add inline links in text blocks.

  1. Add the link text enclosed by square brackets.
  2. Add a set of parenthesis immediately after the closing square bracket.
  3. Add the link URL within the parentheses.
    Ensure that the link starts with a supported URI scheme.

 An example of an inline link using Markdown is: [link text](

BMC Helix Digital Workplace uses hash navigation. Therefore, internal links must begin with hash-forward slash (#/). External links must begin with a URI scheme, such as https:, mailto:, tel:, and so on. 

  1. To add links in text blocks, add the link using Markdown syntax.
    For more information, see To use Markdown syntax for inline links.
  2. To add on-click action links, enter the URL starting with a supported URI scheme.

The following video shows you how to add inline links:


The studio does not allow you to save and publish a page that contains links with unsupported URI schemes. A link with an unsupported URI scheme appears as plain text and is therefore not clickable. If no supported URI scheme is specified, the supported URI scheme will automatically convert to https. 

If a supported URI becomes unsupported after a page is published, that link automatically becomes unclickable. 

How supported and unsupported links appear in the end user console

Before actually clicking a link, users may hover the cursor over the link to check the URL in the lower corner of the browser. For unsupported URI schemes, the browser does not display the URL that the link points to. The following video shows how links appear for supported, unsupported, and unsafe URI schemes (if the URI is considered unsafe to load):

To add on-click links for an entire content block, an image, or a button

  1. Open the studio page.
  2. Select the content block where you want to add an on-click link, and then open its properties panel.
  3. Add the link in the property, as given in the table below:

    Content block Click action



    Link (property for each button in the Button group)

  4. From the Link list, select URL.
  5. Specify the URL, starting with a URI scheme; for example,

Add on-click links on images, content blocks, and buttons

        6. Specify whether the link opens in the same tab or a new tab.

        7. Save the page.

To map catalog services and bundles to click actions in content blocks

You can associate a click action with any published catalog service or service bundle. The click action can be configured to either open the catalog service's profile page or bypass that screen and directly display the service checkout page with the service questionnaire for end users to request the service. 

The following video shows click actions on two buttons. The same service is associated with both the buttons: a click action on one button opens the service profile page while a click action on the other button opens the service checkout page with the questionnaire.

  1. Open the studio page in which you want to associate a catalog service or service bundle to a click action.
  2. Select the content block where you want to add an on-click link, and then open its properties panel.
  3. From the Link list, select Catalog item. Make sure that end users are entitled to view the mapped BMC Helix Digital Workplace Catalog item.  
  4. Click Select
  5. From the Service Catalog list of published services and service bundles, select the service you want to link, and then click Save.
    You can use the search bar to search for services and bundles with a specific name. 
  6. From the Destination page list, select either Item details or Request now
    The Item details option displays the service profile page while the Request now option displays the service checkout page.

  7. Save the page.

The following image shows a service linked to a button:

Use relative links to make your links work without any modification when you move pages between environments. Use relative links when linking to internal pages or pages in your organization. You can add relative links in text blocks and on-click action links to content blocks, images, and buttons.  A page URL looks like this: https://BMCHelixDWPServer:portNumber/dwp/app/<relative-link>. The relative link pattern for each page type is different. 

Note that BMC Helix Digital Workplace uses hash navigation.

  •  To add relative links for on-click actions, select URL from the Link options and enter the relative link.
  •  To add links in text blocks, simply enter the relative link.


  • Use only the relative path from the absolute URL. An absolute URL could be https://BMCHelixDWPServer:portNumberBMCHelixDWPServer:portNumber/dwp/app/#/catalog, while the relative path would simply be #/catalog.
  • In text blocks, provide the relative link in Markdown text.
  • For on-click action links, select Application page from the Link options, and then select the desired page. Starting with version 22.1, BMC Helix Digital Workplace displays the GUID for the service in the address bar of a service profile page. Use this GUID to direct your users to the service page.

Note that a relative link can break if the page it points to does not exist. For example, the relative link does not work if the target page is not available in the new environment or if the page has been deleted or removed. 

The following image shows examples of relative links that you can add in studio pages. The image shows the page type, its respective relative link pattern, and a sample link:

Relative links - URL patterns for different pages types

Where to go from here

Using colors to create visually appealing pages

Duplicating content

Setting up navigation for your workplace

Was this page helpful? Yes No Submitting... Thank you