View source for HowItWorks:Thunderbird

{{HowItWorks}}

'''Thunderbird''' is a free and open-source, cross-platform personal information manager, regrouping email, calendar, contacts, RSS feeds, chat and newsgroups in one application.

== Thunderbird? ==

Thunderbird stands out as a personal information manager with three promises:<ref>{{#cite:Q1486}}</ref>

* '''Privacy''' — "You are not the product." Thunderbird does not collect or sell user data, and users retain ownership of it.
* '''Freedom''' — Thunderbird is free and open-source software; its license, the Mozilla Public License 2.0, "ensures that it will remain free forever".
* '''Voice''' — anyone can get involved, and a contributor-elected council keeps Thunderbird "true to its values and mission".

Thunderbird runs on Windows, macOS and Linux.<ref>{{#cite:Q1489}}</ref>

== A short history ==

The history of Thunderbird is marked by four eventful time periods:

=== 9 pre-releases and the 1.0 milestone (2003–2004) ===

The Thunderbird project was founded in 2003 by Mozilla Foundation under the leadership of [[Person:Scott MacGregor|Scott MacGregor]], with the stated goal "to make communicating and collaborating better".<ref>{{#cite:Q1486}}</ref>

The software went through 9 pre-releases (version 0.1-0.9), before reaching the 1.0 milestone at the end of 2004.<ref>{{#cite:Q1497}}</ref>

According to the Mozilla foundation, a few key selling points makes Thunderbird 1.0 stand apart from contemporary alternatives:<ref>{{#cite:Q1489}}</ref>

* '''Cross-platform availability''': Thunderbird 1.0 works right out-of-box for Windows, Mac OS X and Linux;
* '''Adaptive junk mail controls''': With a dynamic Bayesian filter learning from user action (marking and unmarking emails as spam), the more Thunderbird 1.0 is used, the more accurate its spam filtering becomes;
* '''High customisability''': With built-in support for custom themes and extensions, user can personalise Thunderbird 1.0 to their taste and even add new functionalities;
* '''Easy migration''': Sanctioned, guided built-in migration from Outlook, Eudora, and Netscape Communicator, the most popular commercial email clients at the time.

=== Transition to community stewardship(2012–2015) ===

On July 6, 2012, Mozilla chairman [[Person:Mitchell Baker|Mitchell Baker]] announced a new direction: Mozilla's leadership had concluded that "on-going stability is the most important thing" for Thunderbird and that "continued innovation in Thunderbird is not a priority for Mozilla's product efforts".<ref>{{#cite:Q1488}}</ref> Mozilla would provide security updates through an Extended Support Release process, and the community could organize for ongoing development.<ref>{{#cite:Q1488}}</ref>

The Thunderbird project later called the decision "both a blessing and curse": the community kept the project alive and contributed many features, but a volunteer-driven effort without a proper organization accumulated an inconsistent interface and mounting technical debt.<ref>{{#cite:Q1491}}</ref>

In 2014, contributors established the '''Thunderbird Council''', an elected body "functioning much like a board of directors for an open-source project": it oversees funds, approves budgets and shapes the product roadmap.<ref>{{#cite:Q1486}}</ref>

In June 2015, Thunderbird 38 , released under the stewardship of the newly-elected Thunderbird Council, started shipping the calendar Lightening extension by default.<ref>{{#cite:Q1498}}</ref>

=== Migration away from Mozilla infrastructure and creation of MZLA Technologies Corporation (2015–2020) ===

In late 2015, Mitchell Baker reopened a discussion about Thunderbird's future. According to him, Mozilla is happy to "disentangle the technical infrastructure" and assist the Thunderbird community, with the Mozilla Foundation serving as fiscal sponsor for donations.<ref>{{#cite:Q1492}}</ref>

In 2017, on the advice of a report by Simon Phipps, former president of the OSI, comissioned by Mozilla, the Thunderbird Council announced that the Mozilla Foundation would remain the project's legal and fiscal home, but Thunderbird would migrate off Mozilla Corporation infrastructure and operate independently to continue serving its "over 25 million users" worldwide.<ref>{{#cite:Q1492}}</ref>

In 2020, the project was transferred to '''MZLA Technologies Corporation''', a new for-profit subsidiary fully-owned by the Mozilla Foundation. Cited reasons include easier recrutement, simpler governance, and possibilities to open commercial partnerships and offer paid services.<ref>{{#cite:Q1487}}</ref> Essentially, the controversial move was justified as a necessary evil to ensure that Thunderbird remains financially sustainable as an open-source project.

=== Supernova rebuild, official Android support, and monthly releases (2023–2026) ===

In February 2023, the Thunderbird project announced plans for a ground-up rework with three objectives:<ref>{{#cite:Q1491}}</ref>  

1. make the code base leaner and remove technical debt;
2. rebuild the interface from scratch;
3. switch to a monthly release schedule.

Five months later, in July 2023, Thunderbird 115 "Supernova" shipped. Introducing a card view for the message list, a dynamic unified toolbar, a redesigned application menu, sortable folder modes, a tags view, and improving keyboard and screen-reader accessibility,<ref>{{#cite:Q1490}}</ref>, it is "a modernized overhaul of the software, both visually and technically".<ref>{{#cite:Q1490}}</ref>." according to its release notice. [[Person:Ryan Sipes|Ryan Sipes]], Thunderbird's Product and Business Development Manager, said the release marked "the beginning of a new era for Thunderbird".<ref>{{#cite:Q1490}}</ref>

In October 2024, Thunderbird Android, developed from K-9 Mail, made its first stable release, further fulfilling the cross-platform promise of Thunderbird.<ref>{{#cite:Q1493}}</ref>. As of September 2026, iOS is the only major operating system not yet officially supported by Thunderbird.

Today (2026-09), Thunderbird's release schedule has become extremely regular: one new major version every 4 weeks, and one Extended Support Release per year, typically in July.<ref>{{#cite:Q1495}}</ref> Development of Thunderbird for iOS, described in the July 2026 progress report as the project's "first built from scratch" app, continues actively.<ref>{{#cite:Q1499}}</ref>

== Components and interactions ==

Written in C++, JavaScript, CSS and XHTML,<ref>{{#cite:Q1491}}</ref> Thunderbird is built on the Mozilla platform. As the team describes it: "Thunderbird is literally a bunch of code running on top of Firefox. All the tabs and sections you see in our applications are just browser tabs with a custom user interface."<ref>{{#cite:Q1491}}</ref> The Mozilla platform supplies multi-OS support, the Gecko web renderer, the SpiderMonkey JavaScript engine, as well as security patches and extension support from the Firefox release cycle..<ref>{{#cite:Q1491}}</ref> 

<uml>

@startuml
!theme bluegray
title Thunderbird Components and Interactions

' ============= USER INTERFACE =============
node "Thunderbird UI (mail/ frontend)" {
  component "Mail window\n(folder pane, message list,\nmessage view)" as MAILWIN
  component "Compose window" as COMPOSE
  component "Address book" as ADDRBOOK
  component "Calendar" as CALWIN
  component "Chat" as CHATWIN
}

' ============= APPLICATION LAYER =============
node "Application layer" {
  component "mail/ modules & components\n(account setup, cloudfile,\npreferences, extensions)" as APPMOD
  component "MailExtensions\n(WebExtensions + Experiments)" as EXT
}

' ============= PLATFORM LAYER =============
node "Platform (Firefox / Mozilla platform)" {
  component "Gecko\n(HTML/CSS rendering)" as GECKO
  component "SpiderMonkey\n(JavaScript engine)" as SM
  component "Necko\n(networking)" as NECKO
  component "SQLite\n(storage engine)" as SQLITE
}

' ============= BACKEND =============
node "Backend" {
  component "mailnews/\n(IMAP, POP3, SMTP,\nNNTP, RSS, message store)" as MAILNEWS
  component "calendar/\n(CalDAV, iCalendar)" as CALDAV
  component "chat/\n(IRC, XMPP, Matrix)" as CHATPROTO
}

' ============= STORAGE =============
database "Profile directory\n(prefs.js, message folders,\naddress books, message database)" as PROFILE

' ============= EXTERNAL =============
node "External services" {
  database "Mail servers\n(IMAP / POP3 / SMTP)" as MAILSVR
  database "ISPDB\n(account auto-configuration)" as ISPDB
  database "addons.thunderbird.net" as AMO
  database "Calendar / chat servers" as OTHERSVR
}

' ============= FLOWS =============
MAILWIN --> APPMOD : window chrome & logic
COMPOSE --> APPMOD
CALWIN --> APPMOD
CHATWIN --> APPMOD
APPMOD --> EXT : extension API
APPMOD --> GECKO : render UI\n(HTML / XUL)
APPMOD --> SM : run JS modules
APPMOD --> MAILNEWS : mail operations
MAILNEWS --> NECKO : protocol connections
MAILNEWS --> PROFILE : read / write messages
CALDAV --> NECKO : CalDAV / WebDAV
CALDAV --> PROFILE : calendar data
CHATPROTO --> NECKO : chat protocols
CHATPROTO --> PROFILE : chat logs
MAILNEWS --> MAILSVR : IMAP / POP3 / SMTP
CALDAV --> OTHERSVR : calendar sync
CHATPROTO --> OTHERSVR : chat servers
APPMOD --> ISPDB : autoconfig lookup
EXT --> AMO : install / update

note right of EXT
  Add-ons use stable WebExtension
  APIs; "Experiment" APIs can reach
  into internal Thunderbird APIs.
end note
note right of MAILNEWS
  mailnews/ is the shared Mail and
  Newsgroups backend, also used by
  SeaMonkey.
end note
note right of PROFILE
  All user data lives in one profile
  directory; copying it migrates a
  Thunderbird installation.
end note
note right of GECKO
  Thunderbird's UI is rendered by
  the same engine that renders
  web pages in Firefox.
end note

@enduml
</uml>

<!-- redrawn diagram. The current one is confusing and probably wrong. Some services, like SQLite storage is not accessed at all! -->

=== Source code organization ===

Thunderbird's source code repository is split into multiple sub-directories by functionality: <ref>{{#cite:Q1494}}</ref>

* '''mail/''' — the Thunderbird-specific frontend: user interface files, shared JavaScript modules, and components such as the account setup wizard, the address book front end, the composition window, the chat front end and the preferences tab.
* '''mailnews/''' — "source code specific to the Mail and Newsgroups part of Thunderbird and SeaMonkey": the protocol and storage backend.
* '''calendar/''' — the calendar component, formerly known as the Lightning extension.
* '''chat/''' — the chat component, with one subdirectory per protocol; related code also lives in <code>mail/components/im</code>.
* '''build/''', '''testing/''', '''taskcluster/''' and '''third_party/''' — build, test and vendored-code infrastructure.

=== Addons ===

Since Thunderbird 78 (July 2020 release), all add-ons must be built within Thunderbird's MailExtension framework,<ref>{{#cite:Q1501}}</ref> which uses regular WebExtension technology via standard JavaScript, CSS and HTML. They interact with Thunderbird through dedicated extensions APIs, which are generally stable across releases and subjected to user confirmation for access.<ref>{{#cite:Q1496}}</ref>

== Thunderbird in action ==

=== Account setup ===

Creating an account is a wizard flow. The user enters their name, email address and password; Thunderbird queries the '''ISPDB''' (Internet Service Provider Database), a Thunderbird-run service "used for auto configuring users' email accounts", to auto-fill the incoming and outgoing server settings.<ref>{{#cite:Q1492}}</ref>

<uml>
@startuml
!theme bluegray
title Account setup flow

|#LightGray|User|
start
:enter name, email address\nand password;
|#LightBlue|Thunderbird (account setup wizard)|
:look up the email domain\nin the ISPDB;
if (settings found?) then (yes)
  :prefill IMAP/POP3 and SMTP\nserver settings;
else (no)
  :ask for server details manually;
endif
:test the connection\n(login check);
if (successful?) then (yes)
  :create the account,\nstart fetching mail;
else (no)
  :show error, let the user adjust;
endif
stop

@enduml
</uml>

=== The mail round trip ===

Incoming mail: Thunderbird connects to the server over '''IMAP''' or '''POP3'''<ref>{{#cite:Q1489}}</ref>, downloads new messages into the profile, updates the message database, and notifies the interface. Outgoing mail goes out over '''SMTP'''.<ref>{{#cite:Q1489}}</ref>

<uml>
@startuml
!theme bluegray
title Mail round trip (IMAP fetch and SMTP send)

|#LightGreen|Mail server|
start
:new message arrives\nfor the account;
|#LightBlue|Thunderbird (mailnews/)|
:connect over IMAP\n(sync folders, fetch headers/bodies);
:store messages in the profile,\nupdate the message database;
:notify the UI\n(unread count, message list update);
|#LightGray|User|
:read and reply;
|#LightBlue|Thunderbird (mailnews/)|
:compose the reply;
:send over SMTP;
|#LightGreen|Mail server|
:deliver the message;
|#LightBlue|Thunderbird|
:move a copy to the\n"Sent" folder;
stop

@enduml
</uml>

== Key design decisions ==

=== Riding the Firefox platform ===

The founding architectural decision: build the mail client on top of the Mozilla platform rather than from scratch. Thunderbird inherits cross-platform support, the Gecko renderer, SpiderMonkey, networking and security patches from Firefox.<ref>{{#cite:Q1491}}</ref> The trade-off is a constant chase: with a bit more than a dozen core developers against Firefox's hundreds, "how many times per week things suddenly break in Thunderbird because a C++ interface was renamed, or an API was deprecated, or a building library was upgraded".<ref>{{#cite:Q1491}}</ref> This upstream churn, plus years of volunteer-driven additions, produced the technical debt that motivated the Supernova rebuild.<ref>{{#cite:Q1491}}</ref>

=== From XUL to web technologies ===

Thunderbird's interface was historically built with Mozilla-specific technologies: XUL, XBL and XPCOM. As early as 2017 the project's long-term plan was to migrate to "web technologies", meaning HTML and pure JavaScript, while remaining an installable desktop application.<ref>{{#cite:Q1492}}</ref> The Supernova release (2023) was the visible first step of that rework: "we reworked some of the oldest parts of our code base with the goal of modernizing them to make maintenance and extensibility easier".<ref>{{#cite:Q1490}}</ref><ref>{{#cite:Q1491}}</ref>

=== Community governance, corporate backing ===

Thunderbird pairs an unusual governance structure with an equally unusual corporate one. The '''Thunderbird Council''', elected by contributors since 2014, steers strategy and budget;<ref>{{#cite:Q1486}}</ref> development and operations are run by MZLA Technologies Corporation, a '''for-profit subsidiary of the not-for-profit Mozilla Foundation''', which gives the project "the flexibility to offer optional paid services to sustain Thunderbird's development far into the future".<ref>{{#cite:Q1486}}</ref><ref>{{#cite:Q1487}}</ref> After the uncertainty of the 2012 community handover and the 2015–2017 search for a home, this structure gave the project paid staff, a roadmap and a release cadence.<ref>{{#cite:Q1491}}</ref><ref>{{#cite:Q1492}}</ref>

=== Stable, permissioned add-on APIs ===

Thunderbird's extensibility has long been a selling point, but legacy XUL/XPCOM add-ons broke with nearly every release. The project's answer was to adopt WebExtensions and call them '''MailExtensions''': stable APIs, permission prompts, no forced per-release updates.<ref>{{#cite:Q1496}}</ref> Since Thunderbird 78, only MailExtensions are supported, and "restartless add-ons and non-restartless legacy add-ons using XUL overlays are no longer supported".<ref>{{#cite:Q1501}}</ref>

=== A predictable release train ===

Thunderbird follows a 4-week release cycle: a new Daily (nightly) major version begins every 4 weeks, the code merges into Beta, then into the monthly Release, with point releases as needed 2 weeks after.<ref>{{#cite:Q1495}}</ref> The ESR branch is refreshed once a year, typically in July, and receives point releases as needed every 2 weeks.<ref>{{#cite:Q1495}}</ref> This replaced the earlier yearly-major model which, combined with upstream Firefox changes, at times left Thunderbird unable to build or release "for months at a time".<ref>{{#cite:Q1491}}</ref>

=== Open standards and privacy ===

Thunderbird talks to the outside world through open standards: IMAP, POP3, SMTP, NNTP and RSS for content, CalDAV and iCalendar for the calendar, and open chat protocols.<ref>{{#cite:Q1489}}</ref><ref>{{#cite:Q1494}}</ref> The project's privacy stance is uncompromising: "You are not the product", it does not collect or store user data unless asked, and it will never sell it.<ref>{{#cite:Q1486}}</ref>

== Try it yourself ==

The current version can be checked against Mozilla's official product-details API (verified live on 2026-09-01):

<syntaxhighlight lang="bash" copy>
# What is the latest stable release right now?
curl -s https://product-details.mozilla.org/1.0/thunderbird_versions.json
</syntaxhighlight>

Output (verified live on 2026-09-01):

<pre>
{
    "LATEST_THUNDERBIRD_ALPHA_VERSION": "54.0a2",
    "LATEST_THUNDERBIRD_DEVEL_VERSION": "156.0b1",
    "LATEST_THUNDERBIRD_NIGHTLY_VERSION": "157.0a1",
    "LATEST_THUNDERBIRD_VERSION": "154.0",
    "THUNDERBIRD_ESR": "140.14.1esr",
    "THUNDERBIRD_ESR_NEXT": "153.1.1esr"
}
</pre>

Install the official Flatpak, which is "packaged and maintained by the Thunderbird team":<ref>{{#cite:Q1490}}</ref>

<syntaxhighlight lang="bash" copy>
# Install from Flathub
flatpak install flathub org.mozilla.Thunderbird
</syntaxhighlight>

<syntaxhighlight lang="bash" copy">
# Launch it
flatpak run org.mozilla.Thunderbird
</syntaxhighlight>

Or use your distribution's package:

<syntaxhighlight lang="bash" copy">
# Debian / Ubuntu
sudo apt install thunderbird
</syntaxhighlight>

All of Thunderbird's data lives in a single profile directory (on Linux, <code>~/.thunderbird</code>): preferences, mail folders, address books and the message database. Migrating to a new machine is "really just a matter of copying the profile folder to the right place on the new machine".<ref>{{#cite:Q1487}}</ref>

== References ==

<references/>

== Further reading ==

* [https://www.thunderbird.net/ Thunderbird] — the official website
* [https://blog.thunderbird.net/ The Thunderbird Blog] — release announcements and project news
* [https://developer.thunderbird.net/ Thunderbird Developer Documentation] — architecture, building, add-ons
* [https://hg.mozilla.org/comm-central comm-central] — the source repository
* [https://www.thunderbird.net/en-US/thunderbird/releases/ Thunderbird release notes]
* [https://support.mozilla.org/products/thunderbird Thunderbird support (SUMO)]
* [https://roadmaps.thunderbird.net/ Thunderbird roadmaps]
* [https://www.thunderbird.net/en-US/participate/ Get involved]