> ## Documentation Index
> Fetch the complete documentation index at: https://docs.relayapp.im/llms.txt
> Use this file to discover all available pages before exploring further.

# chat.group_icon_updated

> Read the chat.group_icon_updated data payload and its fields.

`chat.group_icon_updated` fires when a group chat's icon changes.

## Read the payload

The `data` object is the `ChatGroupIconUpdatedEvent` schema from the API contract. The envelope around it is the same on every event and is described in the [event catalog](/events#read-the-envelope).

| Field               | Meaning                                    |
| ------------------- | ------------------------------------------ |
| `chat_id`           | Group chat ID                              |
| `old_value`         | Previous icon URL, or `null`               |
| `new_value`         | New icon URL, or `null` when removed       |
| `changed_by_handle` | The handle that made the change, or `null` |
| `updated_at`        | When the icon URL changed                  |

## Handle the event

Replace the stored icon for `chat_id` with `new_value`, and treat `null` as no icon. Fetch the image when you need it rather than assuming the URL stays valid for long.

## Next steps

* [Update a group photo](/chats/group-photo)
* [Read the chat.group\_name\_updated event](/events/chat-group-name-updated)
* [Choose an event type](/events)