Supported UI Elements
Descriptions and examples of MailExtension APIs to interact with Thunderbird's user interface.
Browser Action
A browser action adds a button to Thunderbird's main toolbar:
It is controlled by the browser_action
manifest key in the extension's manifest.json
file:
If a default_popup
is defined, a popup will be opened and the defined html page will be loaded, when the button is clicked. Additionally, you can use the browserAction
API in your background script to interact with the button to modify badge text, icon, title or its enabled state.
Note: The browserAction
API has been renamed to action
in Manifest V3.
Compose Action
A compose action adds a button to the toolbar of the composer window:
It is controlled by compose_action
manifest key in the extension's manifest.json
file:
If a default_popup
is defined, a popup will be opened and the defined html page will be loaded, when the button is clicked. Additionally, you can use the composeAction
API in your background script to interact with the button to modify badge text, icon, title or its enabled state.
Message Display Action
A message display action adds a button to the toolbar of the message view window:
It is controlled by the message_display_action
manifest key in the extension's manifest.json
file:
If a default_popup
is defined, a popup will be opened and the defined html page will be loaded, when the button is clicked. Additionally, you can use the messageDisplayAction
API in your background script to interact with the button to modify badge text, icon, title or its enabled state.
CloudFile Provider Configuration
Thunderbird supports cloud providers to upload large attachments to a server, instead of attaching them directly to the email. Extensions can register such cloud providers using the CloudFile
API. These providers can be managed in Thunderbird's Composition options:
Menu Items
The menus
API allows modifying Thunderbird's menus by adding or overriding menu items. The menu items can be added to different menus based on the provided context
type. The following values are currently supported:
| All allowed contexts, excluding |
| |
| |
| |
| Context menu of text/password input fields in WebExtension windows, web tabs or message display tabs. |
| |
| |
| Context menu of links in WebExtension windows, in web tabs or in message display tabs. |
| |
| |
| Context menu of WebExtension windows, web tabs or message display tabs, if none of the other content contexts apply (link, selection, image, audio, video, editable, password). |
| Context menu in WebExtension windows, web tabs or message display tabs, if any text has been selected. |
|
``
Last updated