This is beta documentation for Stream Chat React Native SDK v9. For the latest stable version, see the latest version (v8) .

URLPreview

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

attachment

Attachment object used for preview content.

Type
object

additionalPressableProps

Extra props passed to the underlying Pressable used in message components like MessageContent.

Type
object

onLongPress

Default long press handler for message UI.

Type
function

onPress

Default press handler for message UI.

Type
function

onPressIn

Default pressIn handler for message UI.

Type
function

preventPress

Disable press interactions.

Type
boolean

isAttachmentEqual

Custom equality check used for attachment memoization.

Type
function

styles

Style overrides for URL preview internals (container, cardCover, cardFooter, title, description, linkPreview, linkPreviewText).

Type
object

UI Component Props

ImageComponent

Image component used for preview thumbnails.

Drop-in replacement for all underlying Image components in the SDK. Useful for offline image caching. See the Offline Support Guide.

TypeDefault
ComponentTypeImage

Previous
Giphy
Next
URLPreviewCompact