Skip to main content
MindTouch Success Center

Use content IDs for dynamic external links

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). If you need to change the links later, content ID manager allows you to update the links with one change 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.

MindTouch example

Question mark icons Question-Mark-Icon.png appear 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 code at all.

Create content IDs

  1. Navigate to the content ID management tool through Site tools > Dashboard > Content ID Management.
  2. Create a content ID (a string of letters, numbers or a combination of both). 
    Content IDs can only use letters (lower or upper case), numbers, dashes -, underscores _ and periods .
  3. Add a description of your content ID (255-character limit). 
    Content_ID_def.png
  4. Click Add to display the ID and description in the table.
    Content_ID_def2.png
  5. Click the Associations tab and click the pencil link in the far right column.
  6. Use browse navigation or search to to associate a content ID with an article.

Associate via browse 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
 

Test the content ID mapping

After you associate the content ID with an article, you will see it mapped in the Associations tab and can test it and confirm the content ID and association resolves. If you create a content ID named adminguide, append your MindTouch site URL with/@go/cid/adminguide. For example, if your site is http://example.com, enter http://example.com/@go/cid/adminguide into the address bar to be redirected to your associated page.

Filter 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
 

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.

Learn how to use content IDs with contextual help.

  • Was this article helpful?