Skip to main content
A link_preview part asks Relay to render a URL as a native preview card. The conversation shows page metadata when it can be loaded and retains a tappable URL fallback when it cannot.

Send a preview

Add context before the card

Relay preserves ordered parts, so a preview can follow text in the same message:
Each stored part receives a stable part_index, so replies and reactions can target the text or card separately.

Preview metadata and fallback

Relay’s iOS app loads page metadata through the native Link Presentation framework. What the reader sees depends on the destination. The server never rewrites or shortens the destination.

Choosing the part type

Rich previews use the normal message response, history, events, idempotency, replies, reactions, and delivery and read receipts.

Next steps