Links and Link Cards

Make elements clickable: link to another tab, another diagram, or an external address, or drop a link card that previews a web page.

Links connect your diagram to the rest of your work. Any element can become a clickable jump point, and a dedicated link card turns a URL into a tidy bookmark with a title, favicon, and preview image. Together they let a diagram point at the things it describes instead of just naming them.

Linking an element

Give any element a link, and it gains a small "Follow link" badge whose tooltip names the target. A link can point at:

  • A tab in the same diagram, or a specific element on another tab.
  • Another diagram entirely.
  • An external URL, which opens in a new browser tab.

To add one, right-click the element, choose "Link Element", and pick the target. The link follows the element if you move it. For more on tab and element targets, see Linking Across Tabs.

For safety, only http, https, and mailto addresses are allowed as external links. Other URL schemes are blocked.

A link card is a rectangular element that turns a URL into a rich preview: the page's favicon, its title, the site name, and, when available, its preview image. It is the right choice when the link is the content, such as a reference doc, a ticket, or a related page you want visible on the canvas.

Add a link card from the tools, then drag to size it like any shape.
Double-click the empty card to open the link picker and paste in a URL.

The card fills in with the page's title, favicon, and preview image automatically. Clicking the card follows the link.

A link card recolours, moves, locks, layers, and resizes like any other element. To learn how the preview is fetched and what gets shown, see Link Cards.

Choosing between them

Both rely on the same kind of URL, so the choice is about emphasis:

  • Use an element link when an existing shape or node should also be clickable.
  • Use a link card when the bookmark itself is what you want people to see on the canvas.

Drop a link card next to the part of the diagram it supports, so a reader can jump straight from the picture to the source without hunting for it.

Was this article helpful?