Skip to main content
MindTouch Success Center

Update external links dynamically by using Content IDs

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).

MindTouch sites are limited to 1,000 content IDs per site.

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. 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, or external sites—or by putting these help links directly in software systems, like MindTouch. 


How to create content IDs

Step 1: Accessing the content ID management tool

Users with administrator permissions 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). 


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


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.


  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.


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.


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/@go/cid/adminguide.  For example, if your site is, enter 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.  



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. 

  • Was this article helpful?