Skip to content

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
  1. Add an account
  2. When the guess is wrong
  3. Outlook.com and Microsoft accounts
  4. Changing POP to IMAP later
  5. Server settings for common providers
  6. If Thunderbird will not connect

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

  1. Open Account Settings from the menu.
  2. At the bottom of the left pane, click Account Actions and choose Add Mail Account.
  3. 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.

Still not working? When the guess is wrong

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.

Still not working? Outlook.com and Microsoft accounts

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

ProviderIncoming (IMAP)Outgoing (SMTP)
Gmailimap.gmail.com, 993, SSLsmtp.gmail.com, 587, TLS
Outlook.comoutlook.office365.com, 993, SSLsmtp-mail.outlook.com, 587, STARTTLS
Yahoo Mailimap.mail.yahoo.com, 993, SSLsmtp.mail.yahoo.com, 465, SSL
iCloud Mailimap.mail.me.com, 993, SSLsmtp.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.

  1. 01 Mozilla Support: Manual Account Configuration support.mozilla.org
  2. 02 Mozilla Support: Thunderbird and Microsoft email (Office365, Hotmail, Outlook.com) support.mozilla.org
  3. 03 Mozilla Support: Switch from POP to IMAP account support.mozilla.org
  4. 04 Google Workspace Admin Help: Set up Gmail with a third-party email client support.google.com
  5. 05 Microsoft Support: POP, IMAP, and SMTP settings for Outlook.com support.microsoft.com
  6. 06 Yahoo Help: IMAP server settings for Yahoo Mail help.yahoo.com
  7. 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 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