> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-docs-rn-guide-message-privately.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Join A Group
> Join CometChat public and password-protected groups in JavaScript apps using group GUID, type, and password.
## Join a Group
Use `joinGroup()` to join a group.
```typescript theme={null}
const GUID: string = "GUID";
const password: string = "";
const groupType: string = CometChat.GROUP_TYPE.PUBLIC;
CometChat.joinGroup(GUID, groupType, password).then(
(group: CometChat.Group) => {
console.log("Group joined successfully:", group);
}, (error: CometChat.CometChatException) => {
console.log("Group joining failed with exception:", error);
}
);
```
```javascript theme={null}
const GUID = "GUID";
const password = "";
const groupType = CometChat.GROUP_TYPE.PUBLIC;
CometChat.joinGroup(GUID, groupType, password).then(
group => {
console.log("Group joined successfully:", group);
}, error => {
console.log("Group joining failed with exception:", error);
}
);
```
| Parameter | Description |
| ----------- | ------------------------------------------------------- |
| `GUID` | The GUID of the group to join |
| `groupType` | `CometChat.GROUP_TYPE.PUBLIC`, `PASSWORD`, or `PRIVATE` |
| `password` | Required for password-protected groups |
Once joined, you can send and receive messages in the group. CometChat tracks joined groups — you don't need to rejoin each session. Check `hasJoined` on the [`Group`](/sdk/reference/entities#group) object to verify membership.
The method returns a [`Group`](/sdk/reference/entities#group) object with `hasJoined` set to `true`.
## Real-time Group Member Joined Events
Register a `GroupListener` to receive events when members join.
```typescript theme={null}
CometChat.addGroupListener(
"UNIQUE_LISTENER_ID",
new CometChat.GroupListener({
onGroupMemberJoined: (message: CometChat.Action, joinedUser: CometChat.User, joinedGroup: CometChat.Group) => {
console.log("User joined", { message, joinedUser, joinedGroup });
}
})
);
```
```javascript theme={null}
CometChat.addGroupListener(
"UNIQUE_LISTENER_ID",
new CometChat.GroupListener({
onGroupMemberJoined: (message, joinedUser, joinedGroup) => {
console.log("User joined", { message, joinedUser, joinedGroup });
}
})
);
```
Always remove group listeners when they're no longer needed (e.g., on component unmount or page navigation). Failing to remove listeners can cause memory leaks and duplicate event handling.
```javascript theme={null}
CometChat.removeGroupListener("UNIQUE_LISTENER_ID");
```
## Missed Group Member Joined Events
When fetching message history, join events appear as [`Action`](/sdk/reference/messages#action) messages with:
* `action` — `"joined"`
* `actionBy` — [`User`](/sdk/reference/entities#user) who joined
* `actionFor` — [`Group`](/sdk/reference/entities#group) that was joined
***
## Next Steps
Allow members to leave a group
Fetch the list of members in a group
Send messages to group conversations
Programmatically add members to a group