---
source_url: https://www.pubnub.com/docs/sdks/unreal/entities/channel-group
title: ChannelGroup Entity
updated_at: 2026-06-15T12:15:27.884Z
sdk_name: PubNub Unreal SDK
sdk_version: 2.0.5
---

> 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


# ChannelGroup Entity

PubNub Unreal SDK, use the latest version: 2.0.5

As of version 1.1.0, the Unreal Engine software development kit (SDK) supports entities. Entities are SDK objects that bundle operations for a specific resource type and simplify working with PubNub application programming interfaces (APIs).

Use entities to perform common tasks without manually wiring requests. Some PubNub APIs are exposed via entities. Other operations are available on `UPubnubClient` (recommended) or on the `UPubnubSubsystem` object; see [Configuration](https://www.pubnub.com/docs/sdks/unreal/api-reference/configuration) and the API reference for details.

## Create ChannelGroup

Use this factory method to return a local `ChannelGroup` entity for a single channel group. A `ChannelGroup` entity centralizes operations—such as creating a subscription—so you can prototype and build faster.

```cpp
UPubnubChannelGroupEntity* CreateChannelGroupEntity(FString ChannelGroup);
```

| Parameter | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| ChannelGroup | FString | Yes |  | Name of the [channel group](https://www.pubnub.com/docs/general/channels/subscribe#channel-groups) for which to create the entity. |

#### Sample code

:::tip Reference code
This example is a self-contained code snippet ready to be run. It includes necessary imports and executes methods with console logging. Use it as a reference when working with other examples in this document.
:::

###### C++

```cpp
void ASample_ChannelGroupEntity::CreateChannelGroupEntitySample()
{
	// snippet.hide
	UPubnubClient* PubnubClient = GetPubnubClient();
	// snippet.show
	
	//Assumes PubnubClient is created and UserID is set

	// Create a channel group entity for the group you want to work with
	FString ChannelGroupName = TEXT("game_rooms");
	UPubnubChannelGroupEntity* ChannelGroupEntity = PubnubClient->CreateChannelGroupEntity(ChannelGroupName);
}
```

###### Blueprint

## Available operations

The `ChannelGroup` entity provides operations for PubNub [channel groups](https://www.pubnub.com/docs/general/channels/subscribe#channel-groups).

| Operation (click for more information) | Description |
| --- | --- |
| [CreateSubscription(SubscribeSettings)](https://www.pubnub.com/docs/sdks/unreal/api-reference/publish-and-subscribe#subscribe) | Returns a local channel group [subscription object](https://www.pubnub.com/docs/general/channels/subscribe#subscription-types) with [optional parameters](https://www.pubnub.com/docs/general/channels/subscribe#subscription-options). You can then subscribe to receive real-time updates for that channel group. |
| [AddChannelToGroup(Channel, OnAddChannelToGroupResponse)](https://www.pubnub.com/docs/sdks/unreal/api-reference/channel-groups#add-channels-to-a-channel-group) | Adds a channel to the channel group. Requires the Stream Controller add-on. |
| [RemoveChannelFromGroup(Channel, OnRemoveChannelFromGroupResponse)](https://www.pubnub.com/docs/sdks/unreal/api-reference/channel-groups#remove-channels-from-a-channel-group) | Removes a channel from the channel group. Requires the Stream Controller add-on. |
| [ListChannelsFromGroup(OnListChannelsResponse)](https://www.pubnub.com/docs/sdks/unreal/api-reference/channel-groups#list-channels-in-a-channel-group) | Lists all channels in the channel group. Requires the Stream Controller add-on. |
| [RemoveChannelGroup(OnRemoveChannelGroupResponse)](https://www.pubnub.com/docs/sdks/unreal/api-reference/channel-groups#delete-a-channel-group) | Removes the entire channel group. Requires the Stream Controller add-on. |