[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
 [Expand]Product Information
 [Expand]Getting Started with DevExpress Reporting
 [Expand]Creating Popular Reports
 [Collapse]Detailed Guide to DevExpress Reporting
   Introduction to Banded Reports
  [Expand]Providing Data to Reports
  [Expand]Using Report Controls
  [Expand]Shaping Report Data
   Laying out Dynamic Report Contents
  [Expand]Customizing Appearance
  [Collapse]Adding Navigation
    Adding Page Numbers
    Adding Cross-References and Hyperlinks
    Adding Bookmarks and a Document Map
    Adding a Table of Contents
  [Expand]Providing Interactivity
  [Expand]Adding Customary Information
  [Expand]Merging Reports
  [Expand]Using Expressions
  [Expand]Storing and Distributing Reports
  [Expand]Reporting API
 [Expand]Visual Studio Report Designer
 [Expand]Creating End-User Reporting Applications
 [Expand]API Reference
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
This documentation page describes implementations made in our v17.2 release cycle. To learn about functionality shipping with v18.1, navigate to our updated help file experience at docs.devexpress.com. Learn More

Adding Cross-References and Hyperlinks

This document describes how to make an element navigate to other elements in a report or external resources by clicking it in a Print Preview:

Expanded Adding Cross-References

You can improve report navigation using a cross-reference because the link's target is in the same document.

You can add a cross-reference for a report control by setting its XRControl.NavigateUrl property to the required target control's XRControl.Name property value.

Set the XRControl.Target property to _self to specify that the link is in the same document.

In this case, the control behaves like a link meaning that the cursor automatically changes to a hand in a report's preview when hovering the control. You can make a control resemble a link by specifying its appearance properties (for example, change the text's color to blue and underline it).

The link uses the first occurrence if there are multiple instances of an object marked as a link's target.


A report's cross-references are preserved when exporting it to PDF.

Expanded Adding Hyperlinks

A hyperlink means that a link's target is outside the report.

You can use any control as a link by setting the XRControl.NavigateUrl property to the required target document's URL.


Remember to use the "http://" or "https://" prefix when specifying the URL.

You can make a control resemble a link by specifying its appearance properties (for instance, set the underlined text and blue color).

The cursor automatically changes to a hand when hovering the control in a report's preview.

Use the link's XRControl.Target property to specify where to open the target document (in the same preview window, in a new blank window, etc.).


A link's behavior is preserved when exporting a report to most of the available formats (in particular to PDF, HTML, MHT, RTF and Excel).

Is this topic helpful?​​​​​​​