---
source_url: https://www.pubnub.com/docs/chat/chat-sdk/build/features/channels/details
title: Get channel details
updated_at: 2026-06-24T11:03:49.243Z
---

> 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


# Get channel details

Fetch a specific [channel's](https://www.pubnub.com/docs/chat/chat-sdk/learn/chat-entities/channel) metadata with `getChannel()`.

:::note Requires App Context
Enable [App Context](https://youtu.be/9UEoSlngpYI) for your keyset in the [Admin Portal](https://admin.pubnub.com/).
:::

### Method signature

##### Under the hood

`getChannel()` calls App Context API and the JavaScript SDK [getChannelMetadata()](https://www.pubnub.com/docs/sdks/javascript/api-reference/objects#get-channel-metadata) method.

This method takes the following parameters:

```ts
chat.getChannel(
    id: string
): Promise<Channel | null>
```

#### Input

| Parameter | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| id | string | Yes |  | Unique channel identifier (up to 92 UTF-8 byte sequences). |

#### Output

| Type | Description |
| --- | --- |
| `Promise<Channel>` or `Promise<null>` | Object returning either the new channel metadata or null value if the channel doesn't exist. |

#### Errors

If you try to fetch a channel without providing its ID, you will receive the `ID is required` error.

### Sample code

Fetch the `support` channel metadata.

```ts
// reference the "chat" object and invoke the "getChannel()" method
const channel = await chat.getChannel("support")
```