A link card is a bookmark you can see. Paste a URL into it and the card turns into a rich preview of that page: its favicon, its title, the site name, and, when the page provides one, its preview image. It is a clean way to put a reference doc, ticket, or related page on the canvas so the link is part of the picture rather than buried in a tooltip.
Adding and editing a card
A link card behaves like any other boxed element, so it moves, resizes, recolours, locks, and layers in the usual way.
Paste a URL and confirm. The card fetches the preview and fills itself in. To change the URL later, double-click the card again.
Clicking a filled card follows its link, the same as any other linked element.
How the preview is fetched
When you set a URL, livediagram fetches the page's preview once and caches it onto the card. Because the preview is stored with the card, collaborators and anyone who reloads the diagram see the same card without it being fetched again.
- The card shows the title, site name, favicon, and preview image when the page exposes them.
- The preview image and favicon are referenced straight from the source page, so if a page later removes them the card falls back gracefully.
- While there is no preview yet, or if a fetch does not return one, the card shows the bare URL and its host so it is always useful.
Safe by design
Fetching a preview happens on livediagram's server, never from your browser reaching across the web on its own, and that path is built to be safe to run on a public, self-hostable codebase:
- Only
httpandhttpsaddresses are fetched. - Addresses pointing at private networks, local machines, or internal metadata are refused, so a card can never be used to probe somewhere it should not reach.
The result is that a link card is just a friendly preview of a public page, with none of the surprises that fetching arbitrary URLs could otherwise bring.
If a card shows only the bare URL, the page may not publish preview metadata. The link still works, the card just has less to show.
Was this article helpful?