Skip to main content

Add Cross-Reference to Topic

In a publication, there is a structure that references all of the topics (and sub-publications) that exist in the publication. Each reference to a topic or sub-publication is called a "fork" and has its fork:id. This is just for identifying the connection between the publication and the topic / sub-publication and pointing out its position. It is not the same as the topic's xml:id.

For example, if you have a "Safety" topic that appears three times in the same publication, you can link to the fork for the second instance and the link will go to the second "Safety" topic. If you linked to the topic instead of the fork, the link would always go to the first instance of that topic.


It is possible to add cross-references to elements inside other topics, see Link to Element in Other Topic.

To add a cross-reference:

  1. Select the topic or component in the Content Manager to open it in the Editor.

    Content Manager in Paligo. It shows the Documents section contains an Acme 100 Topics folder. Inside the folder there is a publication and many topics, including "Connect to Network (100).

    Alternatively, you can Create a Topic and edit that.

  2. Position the cursor where the link is to be inserted.


    Alternatively, highlight the text that you want to use as link label.

  3. Select the Insert tab in the Toolbar.

  4. Select Link and choose Cross-reference. Insert_Link.png



    Or use the keyboard shortcut Alt + R (Windows) or Option ⌥ + R (Mac) to add the cross-reference.

  5. Enter a text as Link Label. Leave it blank if you want the link text to be the same as the topic title, see Auto-Text for Cross-References.

  6. Locate the target in the tree structure or use the quick search.



    Make your search more efficient by selecting which resource types to search for.

  7. Select whether to make the cross-reference towards the topic or a fork.

  8. Select Save. Save icon.


If you want to change the cross-reference text or apply auto-text, select it to display the cross-reference editor. You can use that to enable or disable auto-text and change the text of the label, see Auto-Text for Cross-References.