> For the complete documentation index, see [llms.txt](https://developer.thunderbird.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.thunderbird.net/thunderbird-development/codebase-overview/chat/notifications.md).
# Notifications
This is a page for documenting the notifications from Chat Core in Thunderbird. This is likely out of date. Notifications are grouped by interface you need to attach the observer to.
{% hint style="warning" %}
*Draft: This page is not complete.*
{% endhint %}
### nsIObserverService
| Topic | Subject | Data | Added | Comment |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account-added | imIAccount([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIAccount.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIAccount.idl)) | null | <1.0 | a new account has been created |
| account-connected | imIAccount([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIAccount.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIAccount.idl)) | null | <1.0 | the account has connected |
| account-connecting | imIAccount([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIAccount.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIAccount.idl)) | null | <1.0 | the account has started a connection attempt |
| account-connect-error | imIAccount([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIAccount.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIAccount.idl)) | null | <1.0 | the account has disconnecting with an error |
| account-connect-progress | imIAccount([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIAccount.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIAccount.idl)) | null | <1.0 | the account is attempting to connect |
| account-disconnected | imIAccount([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIAccount.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIAccount.idl)) | null | <1.0 | the account has disconnected |
| account-disconnecting | imIAccount([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIAccount.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIAccount.idl)) | null | <1.0 | the account is disconnecting without an error reason |
| account-list-updated | imIAccountsService([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIAccountsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIAccountsService.idl)) | null | <1.0 | the list of accounts has been updated |
| account-removed | imIAccount([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIAccount.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIAccount.idl)) | null | <1.0 | an account is about to be removed |
| account-updated | imIAccount([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIAccount.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIAccount.idl)) | null | <1.0 | |
| app-handler-pane-loaded | nsIDOMWindow([git link](https://github.com/mozilla-firefox/firefox/blob/main/dom/interfaces/base/nsIDOMWindow.idl), [searchfox link](https://searchfox.org/comm-central/source/mozilla/dom/interfaces/base/nsIDOMWindow.idl)) | null | <1.0 | Applications pane in preferences window is loaded |
| autologin-processed | imICoreService([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imICoreService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imICoreService.idl)) | null | <1.0 | imICoreService::processAutoLogin() is complete |
| browser-request | prplIRequestBrowser([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/prplIRequest.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/prplIRequest.idl)) | null | <1.0 | Used by protocol plugins to bring up a browser window (e.g. for an OAuth request) |
| closing-conversation | prplIConversation([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/prplIConversation.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/prplIConversation.idl)) | null | <1.0 | |
| contact-moved | imIContactsService (git link, searchfox link)
imIContact
| null | <1.0 | when a contact has been moved (removed from one tag, added to another, or both) |
| contact-tag-added | imIContact | tag.id | <1.0 | when a tag is added to a contact |
| contact-tag-removed | imIContact | tag.id | <1.0 | when a tag is removed from a contact |
| conversation-closed | prplIConversation([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/prplIConversation.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/prplIConversation.idl)) | null | <1.0 | conversation going away |
| conversation-left-chat | prplIConversation([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/prplIConversation.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/prplIConversation.idl)) | null | <1.0 | the user has left the conversation (but it might remain visible) |
| conversation-loaded | nsISupports([git link](https://github.com/mozilla-firefox/firefox/blob/main/xpcom/base/nsISupports.idl), [searchfox link](https://searchfox.org/comm-central/source/mozilla/xpcom/base/nsISupports.idl)) | null or details | <1.0 | subject is a \, if fired because an existing conversation is moved from one window to another, the data parameter ("details") will contain the string "imported". |
| im-sent | prplIConversation([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/prplIConversation.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/prplIConversation.idl)) | message text | <1.0 | on sending an IM (whether or not it succeeded) |
| new-conversation | prplIConversation([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/prplIConversation.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/prplIConversation.idl)) | null | <1.0 | conversation created |
| new-ui-conversation | imIConversation([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIConversationsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIConversationsService.idl)) | null | <1.0 | |
| prpl-quit | imICoreService([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imICoreService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imICoreService.idl)) | null | 1.2 | Core shutdown, was previously purple-quit |
| status-changed | imICoreService([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imICoreService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imICoreService.idl)) | status text | <1.0 | user (not buddy) status change |
| tag-hidden | imITag([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imITagsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imITagsService.idl)) | null | <1.0 | fired when a tag is hidden |
| tag-shown | imITag([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imITagsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imITagsService.idl)) | null | <1.0 | fired when a tag is set to be shown (unhiding it) |
| ui-conversation-closed | | null | <1.0 | |
| unread-im-count-changed | | count of unread messages | <1.0 | fired when the number of unread messages changes |
| new-text | imIMessage([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIConversationsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIConversationsService.idl)) | null | 1.5 | New message is about to be displayed. |
| new-directed-incoming-message | imIMessage([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIConversationsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIConversationsService.idl)) | null | 1.5 | New incoming message that is either a direct message or highlights the user. |
| ui-conversation-replaced | imIConversation([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imICoreService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imICoreService.idl)) | null | 91 | The subject UI conversation is about to be replaced by a new instance (with different interfaces but the same ID). |
| conversation-update-type | imIConversation([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imICoreService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imICoreService.idl)) | null | 91 | The type of the underlying prplIConversation has changed. Is always preceded by a ui-conversation-replaced notification that disposes of the old UIConversation instance, while this will have the new one as subject. |
| account-sessions-changed | imIAccount([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIAccount.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIAccount.idl)) | null | 91 | The account session list has changed |
| account-encryption-status-changed | imIAccount([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIAccount.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIAccount.idl)) | null | 91 | The account encryption status info has changed |
### imIBuddy
| Topic | Subject | Data | Added | Notes |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ----- | ----------------------------------------------------------------------------------- |
| account-buddy-availability-changed | prplIAccountBuddy([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIContactsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIContactsService.idl)) | null | <1.0 | Possibly fired on account buddy status change |
| account-buddy-display-name-changed | imIContactsService (git link, searchfox link)
imIAccountBuddy
| old serverAlias | <1.0 | Fired when setting imIAccountBuddy::serverAlias |
| account-buddy-icon-changed | imIAccountBuddy | null | <1.0 | Fired when setting imIAccountBuddy::buddyIconFilename |
| account-buddy-signed-off | imIAccountBuddy | null | <1.0 | Possibly fired on account buddy status change |
| account-buddy-signed-on | imIAccountBuddy | null | <1.0 | Possibly fired on account buddy status change |
| account-buddy-status-changed | imIAccountBuddy | null | <1.0 | Possibly fired on account buddy status change |
| buddy-added | imIBuddy([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIContactsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIContactsService.idl)) | null | <1.0 | In response to account-buddy-added if the buddy previously had no account buddies |
| buddy-availability-changed | imIBuddy([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIContactsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIContactsService.idl)) | null | <1.0 | possibly fired on imIBuddy status updates |
| buddy-display-name-changed | imIBuddy([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIContactsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIContactsService.idl)) | old serverAlias | <1.0 | possibly in response to account-buddy-display-name-changed on the preferred account |
| buddy-preferred-account-changed | imIContactsService (git link, searchfox link)
imIBuddy (git link, searchfox link)
| null | <1.0 | when setting imIBuddy::preferredAccountBuddy (internally) |
| buddy-removed | imIBuddy([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIContactsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIContactsService.idl)) | null | <1.0 | In response to account-buddy-removed if the buddy no longer has any account buddies |
| buddy-signed-off | imIBuddy([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIContactsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIContactsService.idl)) | null | <1.0 | possibly fired on imIBuddy status updates |
| buddy-signed-on | imIBuddy([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIContactsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIContactsService.idl)) | null | <1.0 | possibly fired on imIBuddy status updates |
| buddy-status-changed | imIBuddy([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIContactsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIContactsService.idl)) | null | <1.0 | possibly fired on imIBuddy status updates |
### imIContact
Note: all imIContact notifications also go to any imITag it belongs to, as well as nsIObserverService.
| Topic | Subject | Data | Added | Notes |
| ------------------------------- | ---------- | ---- | ----- | --------------------------------------------------------------------------------------------------------------- |
| contact-added | imIContact | null | <1.0 | When a new buddy is created with no other contact |
| contact-availability-changed | imIContact | null | <1.0 | Possibly fired on contact status updates |
| contact-display-name-changed | imIContact | null | <1.0 | Fired on setting imIContact::Alias or imIContact::preferredBuddy, or the preferred buddy's display name changed |
| contact-no-longer-dummy | imIContact | null | <1.0 | Fired when a contact is being loaded? |
| contact-preferred-buddy-changed | imIContact | null | <1.0 | Fired on setting imIContact::preferredBuddy |
| contact-removed | imIContact | null | <1.0 | When the last buddy for the contact is removed |
| contact-signed-off | imIContact | null | <1.0 | Possibly fired on contact status updates |
| contact-signed-on | imIContact | null | <1.0 | Possibly fired on contact status updates |
| contact-status-changed | imIContact | null | <1.0 | Possibly fired on contact status updates |
### imITag
| Topic | Subject | Data | Added | Notes |
| ----------------- | ---------- | ---- | ----- | ------------------------------------------------- |
| contact-moved-in | imIContact | null | <1.0 | When a contact has been moved into the tag |
| contact-moved-out | imIContact | null | <1.0 | When a contact has been moved out of the tag |
| tag-hidden | imIContact | null | <1.0 | fired when a tag is hidden |
| tag-shown | imIContact | null | <1.0 | fired when a tag is set to be shown (unhiding it) |
### prplIConversation
| Topic | Subject | Data | Added | Notes |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| chat-buddy-add | nsISimpleEnumerator([git link](https://github.com/mozilla-firefox/firefox/blob/main/xpcom/ds/nsISimpleEnumerator.idl), [searchfox link](https://searchfox.org/comm-central/source/mozilla/xpcom/ds/nsISimpleEnumerator.idl)) | null | <1.0 | When users join a chat. The enumerator elements are prplIConvChatBuddy. |
| chat-buddy-removed | nsISimpleEnumerator([git link](https://github.com/mozilla-firefox/firefox/blob/main/xpcom/ds/nsISimpleEnumerator.idl), [searchfox link](https://searchfox.org/comm-central/source/mozilla/xpcom/ds/nsISimpleEnumerator.idl)) | null | <1.0 | When chat buddies leave a chat. The enumerator elements are nsISupportsString of the user name. |
| chat-buddy-update | prplIConvChatBuddy([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/prplIConversation.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/prplIConversation.idl)) | old name, if the chat buddy is being renamed | <1.0 | data is null if this is not a rename |
| chat-buddy-topic | | null | <1.0 | The chat topic was updated |
| new-text | prplIMessage([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/prplIMessage.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/prplIMessage.idl)) | null | <1.0 | A new message will be written to a conversation. This can be an incoming, outgoing or system message. Subject was purpleIMessage until 1.2. |
| update-text | prplIMessage([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/prplIMessage.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/prplIMessage.idl)) | null | 91 | An existing message is updated based on the `remoteId` of the message. |
| update-buddy-status | | null | <1.0 | away-ness or online/offline |
| update-conv-chatleft | | null | <1.0 | the user has left the chat (it might remain visible) |
| update-conv-title | | null | <1.0 | |
| update-typing | | null | <1.0 | |
| preparing-message | imIOutgoingMessage([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIConversationsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIConversationsService.idl)) | null | 1.5 | Outgoing message before it's been prepared for sending by the protocol |
| sending-message | imIOutgoingMessage([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIConversationsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIConversationsService.idl)) | null | 1.5 | Outgoing message was prepared (and potentially split into multiple messages) and will be sent by the protocol after this observer. |
| chat-update-type | null | null | 91 | Conversation changed between being a chat and a direct message conv (`isChat` toggled). |
| update-conv-icon | prplIConversation([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/prplIConversation.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/prplIConversation.idl)) | null | 91 | The `convIconFilename` of the conversation changed. |
| update-conv-encryption | prplIConversation([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/prplIConversation.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/prplIConversation.idl)) | null | 91 | The `encryptionState` of the conversation changed. |
### imIConversation
| Topic | Subject | Data | Added | Notes |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- | ----- | ------------------------------------------------------------------------------------------------ |
| received-message | imIMessage([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIConversationsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIConversationsService.idl)) | null | 1.5 | New message is about to be prepared for display. |
| new-text | imIMessage([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIConversationsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIConversationsService.idl)) | null | 1.5 | New message is about to be displayed. (Before 1.5 probably just passed along the `prplIMessage`) |
| new-directed-incoming-message | imIMessage([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIConversationsService.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIConversationsService.idl)) | null | 1.5 | New incoming message that is either a direct message or highlights the user. |
### imIUserStatusInfo
| Topic | Subject | Data | Added | Notes |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | ----- | ----- |
| status-changed | imIUserStatusInfo([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIUserStatusInfo.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIUserStatusInfo.idl)) | Status Text (string) | ? | |
| user-icon-changed | imIUserStatusInfo([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIUserStatusInfo.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIUserStatusInfo.idl)) | New icon file name (string) | ? | |
| user-display-name-changed | imIUserStatusInfo([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIUserStatusInfo.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIUserStatusInfo.idl)) | New display name (string) | ? | |
| idle-time-changed | imIUserStatusInfo([git link](https://github.com/thunderbird/thunderbird-desktop/blob/main/chat/components/public/imIUserStatusInfo.idl), [searchfox link](https://searchfox.org/comm-central/source/chat/components/public/imIUserStatusInfo.idl)) | New idle time (number) | ? | |