/ SDKs / Flutter
Chat SDKs Flutter v3
Chat SDKs Flutter
Chat SDKs
Version 3
Sendbird Chat SDK v3 for Flutter is no longer supported as a new version is released. Check out our latest Chat SDK v4

Pin a message

Copy link

Sendbird Chat SDK for Flutter allows you to pin messages in group channels. You can pin all types of messages including text message, file message, and admin message. The pinned messages feature allows users to mark or highlight specific messages which can be announcements, updates, instructions, or any other messages deemed important in a channel. This makes it easier for channel members to find and access important information, even in large or active channels where there may be a high volume of incoming messages.


Copy link
  • The table below shows the types of channels that support pinned messages. See the channel types section to learn about the differences among various channel types.
Open channelGroup channelSupergroup channel

Pinned messages

Not supported

Supported, except ephemeral channels

Not supported

  • Pinned messages can't be sent as silent messages. The isSilent property should be set to false when pinning or unpinning messages.

Pinning a message on send

Copy link

You can pin a new message that you're sending in a channel by setting the isPinnedMessage property to true. This property belongs to the BaseMessageParams class. The default value for this property is false, meaning that the message being sent is not automatically pinned unless specified.

Pinning an existing message

Copy link

You can pin a message, that is already sent in a channel, using the pinMessage() method of the GroupChannel class. Specify the messageId to pin as shown in the code below.

Note: A group channel has to be created before implementing the code below.

try {
  await channel.pinMessage(id);

} catch (exception) {

The following table shows a list of properties related to the pinned messages feature. The pinnedMessageIds, and lastPinnedMessage properties belong to the GroupChannel class.

List of properties

Copy link
Property nameTypeDescription



Specifies an array of message IDs of the pinned messages in a group channel.



Specifies the last message that was pinned in a group channel.

Getting notified when a message is pinned

Copy link

Once a pinned message is sent or an existing message is pinned, the onPinUpdated event handler is invoked. For further information on GroupChannelHandler, see the Add or remove a channel event handler page.