How to Add an Email Account to Thunderbird
Set up any account in Thunderbird: what its automatic configuration guesses from your address, how to reach the manual fields, and what each one expects.
Jump to your problem 6
Thunderbird tries to configure an account from your address alone, and tells you what it guessed before it commits. When the guess is wrong, one button gets you to the fields — which is more than most mail apps offer.
Add an account
- Open Account Settings from the menu.
- At the bottom of the left pane, click Account Actions and choose Add Mail Account.
- Enter your name, address and password, then click Continue.
Thunderbird then works from the part of your address after the @ to look the settings up. For a well-known provider this finishes on its own.
When the guess is wrong
Click Manual Configuration. Thunderbird opens the server names, ports and the IMAP or POP choice for editing, and Re-test checks what you entered before the account is created — so you find out there and then rather than after the first failed send.
Four fields decide whether it works:
- Hostname — incoming and outgoing are usually different.
- Port — 993 or 995 incoming, 465 or 587 outgoing.
- Connection security — SSL/TLS or STARTTLS. This pairs with the port: 465 goes with SSL/TLS and 587 with STARTTLS, and mixing them fails even though each value is valid on its own.
- Username — usually the full address, but not always. Thunderbird’s own Gmail example uses the name without the domain, while a Workspace account uses the whole address.
Outlook.com and Microsoft accounts
These do not use a password in Thunderbird at all. Mozilla gives the authentication method for Microsoft accounts as OAuth2, so Thunderbird opens Microsoft’s own sign-in window and no app password is involved. If you are hunting for one, you do not need it.
One warning if you copy the values from Mozilla’s own article: it prints the incoming host with a typo. Microsoft publishes outlook.office365.com on port 993, and outgoing smtp-mail.outlook.com on 587 with STARTTLS. That typo domain is not Microsoft’s: it is registered to a domain-parking service and answers DNS with a live mail record, so a client pointed at it may hang or fail oddly rather than cleanly refuse. Never retype a password into a server that behaves strangely — check the hostname first.
If Thunderbird reports a password error on a Microsoft account, sign in to webmail first and turn POP and IMAP on there — Microsoft keeps them off by default.
Changing POP to IMAP later
You cannot convert an account in place. Mozilla’s own instructions are to stop the POP account checking for mail, create a second account as IMAP, drag your messages across, and only delete the POP account once you have confirmed the mail is safely moved.
Worth getting right the first time, then — and worth choosing IMAP whenever the provider offers it, so a second device never shows a different mailbox.
Server settings for common providers
| Provider | Incoming (IMAP) | Outgoing (SMTP) |
|---|---|---|
| Gmail | imap.gmail.com, 993, SSL | smtp.gmail.com, 587, TLS |
| Outlook.com | outlook.office365.com, 993, SSL | smtp-mail.outlook.com, 587, STARTTLS |
| Yahoo Mail | imap.mail.yahoo.com, 993, SSL | smtp.mail.yahoo.com, 465, SSL |
| iCloud Mail | imap.mail.me.com, 993, SSL | smtp.mail.me.com, 587, SSL |
For anything not listed, the Email Settings Finder gives the published set for your address and links to the provider page it came from.
If Thunderbird will not connect
Re-test failing on a correct hostname almost always means the password. Gmail, Yahoo, iCloud and others want an app password in a mail app, not your account password, and Outlook.com and GMX need POP or IMAP enabled in the account before anything can connect. The connection troubleshooter takes the four usual causes in order.
How this guide was checked · November 2026
Verified against 7 official sources
Every step, setting and limit in this guide was checked against the provider’s own documentation on support.mozilla.org, support.google.com, support.microsoft.com and 2 more. Anything we couldn’t confirm was left out.
- 01 Mozilla Support: Manual Account Configuration support.mozilla.org
- 02 Mozilla Support: Thunderbird and Microsoft email (Office365, Hotmail, Outlook.com) support.mozilla.org
- 03 Mozilla Support: Switch from POP to IMAP account support.mozilla.org
- 04 Google Workspace Admin Help: Set up Gmail with a third-party email client support.google.com
- 05 Microsoft Support: POP, IMAP, and SMTP settings for Outlook.com support.microsoft.com
- 06 Yahoo Help: IMAP server settings for Yahoo Mail help.yahoo.com
- 07 Apple Support: iCloud Mail server settings for other email client apps support.apple.com
Questions
Frequently asked questions
How do I set Thunderbird up manually?
Start adding the account as usual, then click Manual Configuration when Thunderbird shows what it guessed. That opens the server names, ports and the IMAP or POP choice for editing, and Re-test checks them before the account is created.
How does Thunderbird know my settings?
It looks them up from the part of your address after the @ sign. For a well-known provider that finishes on its own; for a smaller one, or a custom domain, it often cannot and hands you the manual fields.
Which port and security setting go together?
465 pairs with SSL/TLS and 587 with STARTTLS. Mixing them — 465 with STARTTLS, or 587 with SSL/TLS — fails even though every one of those values is correct on its own.
Should the username be my full email address?
Usually, but not always. Thunderbird's own Gmail example uses the name without the domain, while a Google Workspace account uses the whole address. If a correct password is refused, trying the other form is the quickest test.
Do I need an app password for Outlook.com in Thunderbird?
No. Mozilla gives OAuth2 as the authentication method for Microsoft accounts, so Thunderbird opens Microsoft's own sign-in window instead of taking a password. If it reports a password error anyway, enable POP and IMAP in your Microsoft account first.
Related guides
Keep reading
Getting Started App Setup
How to Add an Email Account to Mail on Mac
Add any account to Apple Mail on macOS — the quick route for Gmail, iCloud, Outlook and Yahoo, the manual route for everything else, and the checkbox that hides the port fields.
3 min read
Getting Started App Setup
How to Add Another Email Account on Android (Gmail App)
Add Outlook, Yahoo, iCloud and other email accounts to the Gmail app on Android — automatic and manual IMAP setup, security warnings, and what Gmail's 2027 changes mean.
4 min read
Getting Started App Setup
How to Add an Email Account to Outlook for Windows
Add Gmail, Yahoo, iCloud, Outlook.com or any IMAP account to the new Outlook for Windows or classic Outlook — including manual IMAP/POP setup and app passwords.
4 min read
Getting Started App Setup
How to Add an Email Account to iPhone or iPad Mail
Add Gmail, Outlook, Yahoo, iCloud or any other email account to the Mail app on iPhone and iPad — automatic setup, manual IMAP settings, and fixes when the password is rejected.
4 min read
Posteo Login
Posteo Login: Turn On Recovery Before You Need It
Signing in to Posteo is ordinary. Getting back in is not: the "forgotten password" feature only works if you switched it on beforehand, and with calendar encryption enabled a reset costs you your contacts. What to set up now, and what support can and cannot reach.
4 min read
Posteo Sign Up
Posteo Sign Up: 1 EUR a Month, No Name Required
Posteo has no free tier and no registration form asking who you are. What the three steps actually ask for, the password rules enforced on the way, every payment method including cash by post, and why the mailbox stays silent until the money arrives.
4 min read