Insert Links to Topic Elements

You create a direct inline link to an element in another topic by using the cross-reference.

Remember: Linking to elements in other topics is not a best practice. Instead of linking to an element in another topic, consider reusing that element.
  1. Open a topic and place your cursor where you want to insert a link.
  2. In the toolbar, click the Insert Link icon.
  3. Click the Select file button.
  4. In the Library dialog, select the file that contains the element that you want to link to.
  5. Select the element in another topic that you want to link to by doing the following:
    1. In the Create/Edit Link dialog, click an element and select it from the list that appears.
    2. If prompted about the element ID, click OK and Save.
      Tip: Heretto CCMS generates ID values automatically, but you can enter your own values. The ID values must be unique. Assigning customized values may boost consistency in your documentation.
    3. Click the Insert Content button.
  6. Optional: Change the link text by placing your cursor in the cross-reference and entering custom text.
    Remember: We don't recommend customizing the link text. You need to maintain and modify custom links each time the content changes and the link text is no longer relevant. You need to do that everywhere the link is used.
You inserted a cross-cross reference to the element in another topic.