Pin a message in a group chat

r10s · August 6, 2026, 4:23pm

aaaaaaaand: there is progress

github.com/chatmail/core

feat: pinned messages (#8546)

main ← r10s/pinned-messages

opened 09:06AM - 05 Aug 26 UTC

r10s

+477 -1

this PR adds a "pinned messages API", that will allow UIs to offer the typical t…hings of pinned messages: - add a menu item to pin/unpin any message - show a banner with the pinned messages, taps cycle through them (if more than 1) and scroll to the original bubble - if more than 1 pinned message, UI should show a "scrolling indicator", see existing implementations to get the idea - show a little "pin icon" beside the date in the message bubbles - and more <img width="400" src="https://github.com/user-attachments/assets/05e9061e-5a7b-4f7e-8426-1b6362f74bd0" /> implementation wise, this PR is comparable straight forward - it does not change much of existing flows, only adds, and around half of the added lines are tests and codes :) - a new `set_pinned_state()` api allows to pin/unpin a message. as several other API (chat names, member added etc.) it sends out an info-message, that carries `Chat-Content: message-pinned` resp. `Chat-Content: message-unpinned` header. the changed message is the parent message, similar as used for webxdc updates. - noteworthy: the info message is only in the chat if a message is pinned. if a message is unpinned, it is hidden. this is what most other implementations do as well, unpinning an outdated information is of few interest - when other members or devices receive that message, they change the pinned state accordingly. notifications are done as usual. - finally, there is a `pinned` API to show the little needle beside messages. this is the only API that also exist for cffi, as android/iOS/ubuntutouch work with cffi message objects later, we also want to resend pinned messages in channels, this is comparable easy as well, but to keep discussion on point, i moved that to [another PR](https://github.com/chatmail/core/pull/8549) that is about to discussed once this is merged. android-PR started at https://github.com/deltachat/deltachat-android/pull/4586 closes https://github.com/chatmail/core/issues/7817