Skip to main content
Version: 12 - TBD

Link Previews

When you paste a link to a Console record into a chat or social tool — Slack, Microsoft Teams, Discord, LinkedIn, Telegram, WhatsApp, iMessage and others — that tool fetches the link and shows a small preview card (a title, a description and an icon). These previews are built from Open Graph metadata that the linked page returns.

Cloudomation generates a per-link preview from the link itself, so the card describes exactly what the link opens instead of always showing the same generic site description.

What the preview shows

The preview is derived only from the link's own address — the screen it points to and the record name or id contained in the query string. For example:

LinkPreview description
/custom_object?name=my-objectOpen the Custom Object named "my-object"
/object_template?name=my-templateOpen the Object Template named "my-template"
/flow?name=my-flowOpen the Flow named "my-flow"
/execution?id=<uuid>Open the Execution with ID <uuid>
/advanced_searchOpen Advanced Search

Links that do not match a known screen — for example the workspace root — fall back to the default Cloudomation site description. The card's title and icon are the standard Cloudomation title and logo.

Privacy

Previews are generated without logging in, so they can only ever contain information that is already part of the link you shared:

  • The preview is built purely from the link's screen and its name/id tokens. It never looks the record up, so it reveals nothing about the record's contents, its permissions, or even whether it exists.
  • A link to a record that does not exist previews identically to one that does. The preview is not a lookup and cannot be used to probe for records.
  • Anything that requires authentication is never included in a preview.

Because the record name or id you put in the link is shown verbatim in the preview text, it is escaped before being placed into the page — a crafted link cannot inject markup into the preview card.

How it works

Link-preview crawlers request the page without running JavaScript, so Cloudomation serves them a small page whose Open Graph tags are filled in from the requested address. Regular browsers are unaffected: opening or refreshing a Console link loads the application exactly as before. Clicking a preview opens the linked screen in the Console as usual (you may be asked to log in first).