React
iOS
Android
Flutter
Angular
JavaScript
Unity
Unreal
Node
Python
Ruby
PHP
Java
.NET
Go
RESTURLPreview
URLPreview renders rich link previews for message attachments. This is the default component for the UrlPreview prop.
Best Practices
- Use rich previews when link context is important.
- Keep preview text concise for better truncation.
- Reuse default safe URL opening behavior in custom handlers.
- Keep custom styles additive to preserve spacing and hit targets.
- Use compact mode (
URLPreviewCompact) when you need denser message rows.
Props
| Prop | Description | Type |
|---|---|---|
attachment | Attachment object used for preview content. | object |
additionalPressableProps | Extra props passed to the underlying Pressable used in message components like MessageContent. | object |
onLongPress | Default long press handler for message UI. | function |
onPress | Default press handler for message UI. | function |
onPressIn | Default pressIn handler for message UI. | function |
preventPress | Disable press interactions. | boolean |
isAttachmentEqual | Custom equality check used for attachment memoization. | function |
styles | Style overrides for URL preview internals (container, cardCover, cardFooter, title, description, linkPreview, linkPreviewText). | object |
ImageComponent is provided through WithComponents and read internally via useComponentsContext().