# Event Object

### Events

Events allow the client to stay up to date with changes to the chat. Examples are a new message, a user's image that updated, a reaction, or a member joining the channel. There are a 4 different type of events. These first 2 types of events you receive if you're connected to Stream, no further action is needed to receive these events:

- **Client events** : You always receive these events. Examples are connection.recovered, health.check and connection.changed

- **Notification events:** Notification events notify you when something changed on a channel you are a member of even if you're not explicitly watching that channel. One example is someone starting a new channel to message you while you are currently in the app. All notification event type start with notification

The last 2 groups of events require you to subscribe to them

- **User presence events** : queryUsers, queryChannels and channel.watch() allow you to specify presence=True, if you specify this option you'll opt in to receiving updates about the users on these channels. You'll receive events when they go online/offline or their data is updated

- **Channel events** : if you call queryChannels with watch=true, or you call channel.watch() you'll opt-in to receiving events for the given channels. Examples are new messages, people joining the chat etc.

A full list of events is shown below. The next section of the documentation explains how to listen for events.

| Event                              | Trigger                                                                                    | Recipients                                                                  | Type                |
| ---------------------------------- | ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------- | ------------------- |
| channel.deleted                    | when a channel is deleted                                                                  | clients watching the channel                                                | channel event       |
| channel.hidden                     | when a channel is mark as hidden                                                           | clients from the user that marked the user as hidden (see hiding channels)  | channel event       |
| channel.truncated                  | when a channels' history is truncated                                                      | clients watching the channel                                                | channel event       |
| channel.updated                    | when a channel is updated                                                                  | clients watching the channel                                                | channel event       |
| channel.visible                    | when a channel is made visible                                                             | clients from the user that marked the user as visible (see hiding channels) | channel event       |
| connection.changed                 | when the state of the connection changed                                                   | local event                                                                 | client event        |
| connection.recovered               | when the connection to chat servers is back online                                         | local event                                                                 | client event        |
| health.check                       | every 30 second to confirm that the client connection is still alive                       | all clients                                                                 | client event        |
| member.added                       | when a member is added to a channel                                                        | clients watching the channel                                                | channel event       |
| member.removed                     | when a member is removed from a channel                                                    | clients watching the channel                                                | channel event       |
| member.updated                     | when a channel member is updated (promoted to moderator/accepted/.rejected the invite)     | clients watching the channel                                                | channel event       |
| message.deleted                    | when a message is deleted                                                                  | clients watching the channel                                                | channel event       |
| message.new                        | when a new message is added on a channel                                                   | clients watching the channel                                                | channel event       |
| message.read                       | when a channel is marked as read                                                           | clients watching the channel                                                | channel event       |
| message.updated                    | when a message is updated                                                                  | clients watching the channel                                                | channel event       |
| notification.added_to_channel      | when the user is added to the list of channel members                                      | clients from the user added that are not watching the channel               | notification event  |
| notification.channel_deleted       | when a channel is deleted                                                                  | clients from members that are not watching the channel                      | notification event  |
| notification.channel_mutes_updated | when a channel is muted                                                                    | clients from the user that muted the channel                                | notification event  |
| notification.channel_truncated     | when a channels' history is truncated                                                      | clients from members that are not watching the channel                      | notification event  |
| notification.invite_accepted       | when the user accepts an invite                                                            | clients from the user invited that are not watching the channel             | notification event  |
| notification.invite_rejected       | when the user rejects an invite                                                            | clients from the user invited that are not watching the channel             | notification event  |
| notification.invited               | when the user is invited to join a channel                                                 | clients from the user invited that are not watching the channel             | notification event  |
| notification.mark_read             | when the total count of unread messages (across all channels the user is a member) changes | clients from the user with the new unread count                             | notification event  |
| notification.message_new           | when a message is added to a channel                                                       | clients that are not currently watching the channel                         | notification event  |
| notification.mutes_updated         | when the user mutes are updated                                                            | clients from the user that updated the list of mutes                        | notification event  |
| notification.removed_from_channel  | when a user is removed from the list of channel members                                    | clients from the user removed that are not watching the channel             | notification event  |
| reaction.deleted                   | when a message reaction is deleted                                                         | clients watching the channel                                                | channel event       |
| reaction.new                       | when a message reaction is added                                                           | clients watching the channel                                                | channel event       |
| reaction.updated                   | when a message reaction is updated                                                         | clients watching the channel                                                | channel event       |
| typing.start                       | when a user starts typing                                                                  | clients watching the channel                                                | channel event       |
| typing.stop                        | when a user stops typing                                                                   | clients watching the channel                                                | channel event       |
| user.banned                        | when the user is banned                                                                    | clients for the banned user                                                 | client event        |
| user.deleted                       | when a user is deleted                                                                     | clients subscribed to the user status                                       | user presence event |
| user.presence.changed              | when a user status changes (eg. online, offline, away, etc.)                               | clients subscribed to the user status                                       | user presence event |
| user.unbanned                      | when the user ban is lifted                                                                | clients for the banned user                                                 | client event        |
| user.updated                       | when a user is updated                                                                     | clients subscribed to the user status                                       | user presence event |
| user.watching.start                | when a user starts watching a channel                                                      | clients watching the channel                                                | channel event       |
| user.watching.stop                 | when a user stops watching a channel                                                       | clients watching the channel                                                | channel event       |
| notification.mark_unread           | when the user marks a message as unread                                                    | clients from the user with the new unread count                             | notification event  |

### Event Object

| name               | type   | description                                                 | default | optional |
| ------------------ | ------ | ----------------------------------------------------------- | ------- | -------- |
| cid                | string | Channel ID                                                  |         | ✓        |
| type               | string | Event type                                                  |         |          |
| message            | object | [Message Object](/chat/docs/<framework>/message_format/)    |         | ✓        |
| reaction           | object | [Reaction Object](/chat/docs/<framework>/send_reaction/)    |         | ✓        |
| channel            | object | [Channel Object](/chat/docs/<framework>/creating_channels/) |         | ✓        |
| member             | object | User object for the channel member that was added/removed   |         | ✓        |
| user               | object | User object of the current user                             |         | ✓        |
| me                 | object | User object of the health check user                        |         | ✓        |
| total_unread_count | int    | the number of unread messages for current user              |         | ✓        |
| watcher_count      | int    | Number of users watching this channel                       |         | ✓        |

---

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

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