Skip to main content
MindTouch Success Center

Update external links dynamically

This page applies to:MindTouch (current)

Dynamically update your external links via content IDs. Associate content IDs to URLs of your MindTouch pages whenever you want to add links for those pages to your external sites, emails or blogs (including contextual help). Should you later need to change the links, our content Id manager allows you to update the links all at once instead of finding and updating each link manually (if you even have access to those locations).
 

Only administrators can associate content IDs to URLs of specific MindTouch pages.

 

Use it like a pro


You've probably noticed blue help links like this one throughout your MindTouch site. These help links all contain content IDs along with contextual help. We use contextual help to allow our users to view information without having to leave their sites or systems. And what is great for us, is that by using content IDs, we can manage those help links from our support site without having to change the product at all! There are many ways you can leverage content IDs, whether it is just sharing a link through emails, blogs, external sites or by putting these help links directly in software systems like MindTouch does. 

 

How to create content IDs


Step 1: Accessing the content ID management tool

Administrator users can access the Content ID Manager by navigating to Site tools > Dashboard > Content ID Management.

Step 2: Add content ID definitions

When creating content IDs, you can only use letters (lower or upper case), numbers, dashes -, underscores _ and periods ..

  1. Create a content ID (a string of letters, numbers or a combination of both).
  2. Add a description of your content ID (255-character limit). 

Content_ID_def.png

  1.  Click Add to display the ID and description in the table:

Content_ID_def2.png
 

Step 3: Create associations

  1. To set up an association for a content ID, click the Associations tab. Notice that Path is empty for the content ID. You need to set the path for the article that you want to resolve.

Content_ID_assoc.png

  1. Click the pencil link in the far right column.
  2. Use one of the following two ways to associate a content ID with an article: (1) via navigation or (2) via search:

Associate via navigation

Expand the hierarchy to locate the article that you want to associate. In the example below our Administration Guide was selected as the article to associate. Clicking Use Selected the Content ID adminguide is associated with the Administration Guide.

If a user attempts to navigate to a page with a non-existent content ID, then the content ID will be generated with the name DEFAULT. This is needed in order to redirect users back to the homepage.

Nav_associate.png

Associate via search

Click on the Search tab, enter a search term and click Search. This will return a set of results that you can select from and then click Use Selected.

ID_Search_assoc.png
 

Step 4: Test the content ID mapping

Once you have associated the content ID with an article, you will see it mapped in the Associations tab. Now that it is associated, you can test it and confirm the content ID and association resolves. To do so, if we created a content ID named adminguide, append your MindTouch site URL with?cid=adminguide.  For example, if your site is http://example.com, enter http://example.com?cid=adminguide into the URL address bar to  be redirected to your associated page.

 

Filtering content IDs


You have the ability to filter content IDs at the top of either tab by entering a search term or unchecking the Show mapped or Show unmapped checkboxes. As you add more content IDs, this will make it easier to filter out what content IDs still need associations.  

ID_assoc.png
 

Troubleshooting


If the content IDs are not loading, the issue most likely has to do with a JavaScript error. Use your browser's developer tool (such as inspect element on Chrome) to find the error.