# System Message

A system message is a message generated by a system event, such as banning or muting a user. These are sent from the backend and displayed via the [`VirtualizedMessageList`](/chat/docs/sdk/react/v11/components/core-components/virtualized-list/) and [`MessageList`](/chat/docs/sdk/react/v11/components/core-components/message-list/) components automatically. In this guide, we will demonstrate how to create and override the default component.

### Default System Message Component

For reference, the default system message component, [`EventComponent`](https://github.com/GetStream/stream-chat-react/blob/master/src/components/EventComponent/EventComponent.tsx) (image below) displays all pertinent information about the event that occurred. The two list components display these messages only if message is of type `system` (`message.type === "system"`).

![Default System Message](@chat-sdk/react/v13/_assets/default-system-message.png)

### Custom System Message Component

Our custom component will display the message text, date, and the actor (user who triggered the event) with added styling. For this complete override of the default component, we will utilize the [`MessageSystem`](/chat/docs/sdk/react/v11/components/core-components/channel#messagesystem/) prop on [`Channel`](/chat/docs/sdk/react/v11/components/core-components/channel/) through which it's being passed to [`ComponentContext`](/chat/docs/sdk/react/v11/components/contexts/component-context/) which allows you to hook into the component override mechanism used throughout the SDK.

<admonition type="note">

To see your custom component in action, try muting a user by using the `/` command. For example, type `/mute` followed by a user mention, `@`. These commands must be enabled in the [Dashboard](https://dashboard.getstream.io/).

</admonition>

<Tabs>

</Tabs>

![Custom System Message](@chat-sdk/react/v13/_assets/custom-system-message.png)


---

This page was last updated at 2026-05-22T16:32:11.038Z.

For the most recent version of this documentation, visit [https://getstream.io/chat/docs/sdk/react/v11/guides/customization/system-message/](https://getstream.io/chat/docs/sdk/react/v11/guides/customization/system-message/).