Table of Contents
User Guide
Linking in Topics

Create links to elements within a topic, to other topics, or to external sources.
Adding a link enables you to provide contextual or supplemental information. You can create a link to another location in the topic, another topic, or an external resource. Depending on where you’re linking to, you’ll either insert a local link, cross-reference, or key reference.
Local links are direct links to elements in the same topic or another topic. In Task topics, local links are useful for creating links to previous steps. When local links are used, you don’t have to worry about maintaining the link, for example, if the step order changes. For more information, see Local Links.
Cross-references (xref) link to a file in the map or an external resource, such as a website or PDF file. Because cross-references are direct links, we recommend only usinge cross-references for external resources. For more information, see Cross-References.
If you want to link to another file in the same map, we recommend using key references. Key references (keyref) are indirect links to keys assigned to files in a publication map. This is a better method of linking because, unlike cross-references, it references a target (a key) not a specific topic. For more information, see Key References.