Linking and References

Last modified by Eleni Cojocariu on 2026/03/19 08:10

Explanation

Pages can be linked using Pages can be linked using different syntaxes or editors.

An internal link is a link created using a Page reference to point to another Page in the wiki. They can be tracked as backlinks and can be automatically updated when the target Page is moved/renamed.

internal-link.png

An external link is any link that uses a direct URL (e.g., direct URLs, bookmarks, links shared from outside the wiki). They are not affected by Page move/rename. External links can be easily identified by the small icon displayed next to the link, as shown below:

external-link-icon.png

Page References

A Page reference uniquely identifies a Page by its location within the wiki structure. A Page reference represents the path to a Page, using separators to describe its position relative to a wiki and parent Pages.

Page references are commonly used:

  • As values of macro parameters that expect a page reference (for example, the Include macro's reference parameter);
  • When calling script APIs that operate on Pages.

By default, the "Page reference" displayed in the "Information" tab is relative to the current wiki. 

page-reference.png

You can:

  • Use the button on the left to obtain a global (absolute) reference;
  • Use the button on the right to copy the Page reference to the clipboard.

Backlinks represent the inverse relationship of links: they indicate which Pages contain links pointing to a given Page. Backlinks are discovered and maintained through internal mechanisms such as link indexing, and they are only available for links that XWiki can interpret (internal links using XWiki syntax). You can view the backlinks of a Page in the "Information" tab.

More

To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.

Related

Get Connected