# Gallery

Component to render image attachments within the [`MessageList`](/chat/docs/sdk/react-native/v5/ui-components/message-list/).

## Basic Usage

You can customize the `Gallery` component and provide it back to the SDK via the [`Gallery`](/chat/docs/sdk/react-native/v5/core-components/channel#gallery/) prop on `Channel` if desired.

```tsx
import { Channel, Gallery } from 'stream-chat-react-native';

<Channel Gallery={() => <Gallery preventPress />}
```

## Props

### `additionalTouchableProps`

<partial id="chat-sdk/react-native/v5/_partials/common-content/ui-components/channel/props/additional_touchable_props"></partial>

### `alignment`

<partial id="chat-sdk/react-native/v5/_partials/common-content/contexts/message-context/alignment"></partial>

### `groupStyles`

<partial id="chat-sdk/react-native/v5/_partials/common-content/contexts/message-context/group_styles"></partial>

### `hasThreadReplies`

Weather current message has any thread replies or not. This `boolean` is used for setting borderBottomLeftRadius for left aligned messages and borderBottomRightRadius for right aligned messages.

| Type    | Default                 |
| ------- | ----------------------- |
| Boolean | `!!message.reply_count` |

### `images`

<partial id="chat-sdk/react-native/v5/_partials/common-content/contexts/message-context/images"></partial>

### `legacyImageViewerSwipeBehaviour`

<partial id="chat-sdk/react-native/v5/_partials/common-content/ui-components/channel/props/legacy_image_viewer_swipe_behaviour"></partial>

### `messageId`

Id of the current message.

| Type   |
| ------ |
| String |

### `messageText`

Text content of current message - `message.text`. This prop gets used for styling purpose of gallery.

| Type   |
| ------ |
| String |

### `onLongPress`

<partial id="chat-sdk/react-native/v5/_partials/common-content/contexts/message-context/on_long_press"></partial>

### `onPress`

<partial id="chat-sdk/react-native/v5/_partials/common-content/contexts/message-context/on_press"></partial>

### `onPressIn`

<partial id="chat-sdk/react-native/v5/_partials/common-content/contexts/message-context/on_press_in"></partial>

### `preventPress`

If true, `onPress` handler will be disabled.

| Type    | Default |
| ------- | ------- |
| Boolean | false   |

### `setSelectedMessage`

<partial id="chat-sdk/react-native/v5/_partials/common-content/contexts/image-gallery-context/set_selected_message"></partial>

### `setMessages`

<partial id="chat-sdk/react-native/v5/_partials/common-content/contexts/image-gallery-context/set_messages"></partial>

### `setOverlay`

<partial id="chat-sdk/react-native/v5/_partials/common-content/contexts/overlay-context/set_overlay"></partial>

### `threadList`

<partial id="chat-sdk/react-native/v5/_partials/common-content/contexts/message-context/thread_list"></partial>

### `videos`

<partial id="chat-sdk/react-native/v5/_partials/common-content/contexts/message-context/videos"></partial>

## UI Component Props

### `VideoThumbnail`

<partial id="chat-sdk/react-native/v5/_partials/common-content/ui-components/channel/props/video_thumbnail"></partial>

---

This page was last updated at 2025-08-15T14:16:16.789Z.

For the most recent version of this documentation, visit [https://getstream.io/chat/docs/sdk/react-native/v5/ui-components/gallery/](https://getstream.io/chat/docs/sdk/react-native/v5/ui-components/gallery/).