---
source_url: https://www.pubnub.com/docs/chat/kotlin-chat-sdk/learn/chat-entities/thread-channel
title: ThreadChannel object
updated_at: 2026-06-15T12:11:38.662Z
---

> Documentation Index
> For a curated overview of PubNub documentation, see: https://www.pubnub.com/docs/llms.txt
> For the full list of all documentation pages, see: https://www.pubnub.com/docs/llms-full.txt


# ThreadChannel object

`ThreadChannel` represents a single thread (channel) in a chat.

## Properties

The `ThreadChannel` interface extends the [Channel interface](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/learn/chat-entities/channel), so it takes its properties. It also has:

```kotlin
interface ThreadChannel : Channel {
    val parentMessage: Message
    val parentChannelId: String
}
```

| Parameter | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| parentMessage | Message | Optional |  | Message for which the thread was created. |
| parentChannelId | String | Optional |  | Unique identifier of the main channel on which you create a subchannel (thread channel) and thread messages. |

## Methods

The `ThreadChannel` object exposes the following methods.

### Regular methods

* [getMessage()](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/build/features/messages/details#get-message-details)
* [getHistory()](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/build/features/messages/threads#get-historical-thread-message)
* [getPinnedMessage()](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/build/features/messages/pinned#get)
* [pinMessage()](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/build/features/messages/threads#pin-thread-message-to-thread-channel)
* [pinMessageToParentChannel()](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/build/features/messages/threads#pin-thread-message-to-parent-channel)
* [unpinMessage()](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/build/features/messages/threads#unpin-thread-message-from-thread-channel)
* [unpinMessageFromParentChannel()](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/build/features/messages/threads#unpin-thread-message-from-parent-channel)
* [update()](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/build/features/channels/updates#update-channel-details)

### Event listeners

* [onThreadChannelUpdated()](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/build/features/channels/updates#get-channel-updates)
* [onThreadMessageReceived()](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/build/features/channels/watch)

All methods available under the [Channel object](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/learn/chat-entities/channel) also apply to `ThreadChannel`.

## Use case

`ThreadChannel` methods enable:

* Creating and replying in [threads](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/build/features/messages/threads)
* [Pinning](https://www.pubnub.com/docs/chat/kotlin-chat-sdk/build/features/messages/threads#pin-thread-message-to-thread-channel) important information