Adding Category Help Text in Cognidox
Enhance Category Descriptions with Links and Useful Information
This article explains how to add explanatory text about category content, include useful links, and control how links are displayed.
Videos in this article
![]()
- Adding category help text with a URL
- Adding a link to a Cognidox document in the category help text
- Help text: advanced techniques
What's in this article?
This article contains the following information for Admin users:
- Adding help text to a category, and including a URL
- Including a link to a Cognidox document in the help text
- Improving help text
Tip: If you want more on this topic, check out the online help.
Adding help text with a URL link
You can include a URL in category help text.
To add help text to a category listing:
- Navigate to the category, click Manage this Category, and display the Name & Help tab.
- Enter some text in the Help text field (hover over the help icon to see pop-up help).
- If you want to include a URL, enter it in square brackets.
- Click Update Help Information.
See also this help topic.
Adding a Cognidox document link to help text
Following on from the previous section, here's how to add a link to a Cognidox document in the category help text.
To add a document link in category help text:
- Navigate to the category, click Manage this Category, and display the Name & Help tab.
- Copy and paste the document number into a suitable place in the existing Help text field. You don't need any special formatting (like square brackets).
- Click Update Help Information.
See also this help topic.
Advanced help text techniques
In this section you'll learn how to:
- Create a subtitle to make your help text stand out (at [00:26] in the video)
See also this help topic - Display links as HTML overlays, specifying a version (at [01:36] in the video)
See also this help topic.
Watch the video
To add a subtitle to the category help text:
- Navigate to the category, click Manage this Category, and display the Name & Help tab.
- Enter the subtitle text in the New subtitle field.
- Click Rename.
To preview a document link as an HTML overlay (rather than opening the Document Details page):
- Navigate to the category, click Manage this Category, and display the Name & Help tab.
- Edit the Help text field to include a link to the Cognidox document. You must specify a version, and use the following syntax:
[<your-cognidox-server>/vdata/<docnum>-<version>.html]
- Click Update Help Information.