Profile folder - Thunderbird: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
 
(44 intermediate revisions by 8 users not shown)
Line 1: Line 1:
''This article is about Thunderbird's profile folder. See also [[Profile folder - Firefox]] and [[Profile folder - SeaMonkey]].''
''This article is about Thunderbird's profile folder. See also [[Profile folder - Firefox]] and [[Profile folder - SeaMonkey]].''


Thunderbird stores all of your personal information such as messages, address books and settings in a folder called the [[:Category:Profiles | profile]]. Its stored outside of your program directory to make it easier to upgrade without risking losing your data. Your profiles are not deleted if you uninstall Thunderbird.
Thunderbird stores all personal data such as messages, address books and configuration settings in an OS folder called the [[:Category:Profiles | profile]]. A profile can contain one or more account for mail, RSS, news, etc. The first time you start Thunderbird it will automatically create a profile in a default location if it does not already exist. You can also use the [[Profile Manager]] to create a profile wherever you want (but don't create it in the Thunderbird program directory) or to delete or rename one.


The first time you start Thunderbird it will automatically create a default profile in a default location if you don't already have one. You can create additional profiles (in whatever location you want) , delete or rename them, or specify a different default profile using the [[Profile Manager]].  
It is a good idea to periodically [[Profile_backup| backup your profile]] to a safe location. Thunderbird doesn't delete a profile when uninstalling, upgrading or re-installing (it is stored in a directory outside of your program directory), but to avoid any risk of accidentally affecting or deleting it as a side effect of an update it is a good idea to back it up before taking such actions.


Each profile can have one or more accounts. Thunderbird doesn't let you switch profiles without exiting, unlike Outlook Expresses identities. However, the [http://nic-nac-project.de/~kaosmos/index-en.html#profname profile switcher] extension will let you do that.  
Thunderbird does not let you switch profiles without exiting, unlike Outlook Expresses identities. However, the [https://addons.mozilla.org/en-US/firefox/addon/profileswitcher/ profile switcher] extension will let you switch profiles.  


==Finding your profile==
==Finding your profile==


Profiles are placed in the same area by default but are named randomly for additional security. If you chose a custom location, see [[#Other methods of finding a profile|Other methods of finding a profile]] below.
Profile folders default to a standard location but are named randomly for additional security. You can set a custom location using [[#Other methods of finding a profile|other methods]] mentioned below.


The [[installation directory]] includes a folder named "profile" (for example, <tt> C:\Program Files\Mozilla Thunderbird\defaults\profile</tt> on Windows), but this folder contains program defaults, <u>not</u> your user profile data.
The [[installation directory]] includes a folder named "profile" (for example, ''C:\Program Files\Mozilla Thunderbird\defaults\profile'' on Windows), but this folder contains program defaults, <u>not</u> your user profile data.  On Windows 2000/XP/Vista and on Linux, the folder containing your user profile data is hidden by default and you will need to [[show hidden files and folders]] to navigate to the profile folder.


===Windows 95, 98, and ME===
'''The easiest way to find your profile is to click on the "Show Folder" button in Help -> Troubleshooting Information'''. That launches windows explorer (or the equivalent file manager for your operating system) with the profile folder selected. That feature was added in Thunderbird 5.0.  
 
Profile folders are in <tt>C:\Windows\Application Data\Thunderbird\Profiles\<Profile name>\</tt> or <tt>C:\Windows\Profiles\<Windows user name>\Application Data\Thunderbird\Profiles\<Profile name>\</tt> .


===Windows 2000 and XP===
===Windows 2000 and XP===
{{Right-pic|Appdata.png}}  
{{Right-pic|Appdata.png}}  
#Choose Start &rarr; Run
#Choose Start &rarr; Run
#Type in <tt>%APPDATA%</tt>
#Type in ''%APPDATA%''
#Press OK. A Windows Explorer window will appear.
#Press OK. A Windows Explorer window will appear.
#In the Windows Explorer window, choose Mozilla &rarr; Thunderbird &rarr; Profiles. Each folder in this folder is a profile on your computer.
#In the Windows Explorer window, choose Thunderbird &rarr; Profiles. Each folder in this folder is a profile on your computer.
 
You can also navigate directly to your profile folder at the following path:
* ''C:\Documents and Settings\''<Windows user name>''\Application Data\Thunderbird\Profiles\<Profile name>''


You can also navigate directly to your folder at the path <tt>C:\Documents and Settings\''<Windows user name>''\Application Data\Thunderbird\Profiles\</tt> . The Application Data folder is a hidden folder; to show hidden folders, open Windows Explorer and choose "Tools &rarr; Folder Options &rarr; View (tab) &rarr; Show hidden files and folders".
The Application Data folder is a hidden folder; to show hidden folders, open Windows Explorer and choose "Tools &rarr; Folder Options &rarr; View (tab) &rarr; Show hidden files and folders".


===Windows Vista===
===Windows Vista, 7, 8.1 and 10 ===
[[Image:VistaStartMenu.png]]
[[Image:VistaStartMenu.png]]
#Open the Windows Start menu  
#Open the Windows Start menu
#In the the "Start Search" box, type in <tt>%APPDATA%</tt> and press "Enter".  [http://blogs.msdn.com/tims/archive/2006/09/18/windows-vista-secret-3-bringing-back-start-run.aspx]
#In the the "Start Search" box, type in ''%APPDATA%'' [http://blogs.msdn.com/tims/archive/2006/09/18/windows-vista-secret-3-bringing-back-start-run.aspx]
# A Windows Explorer window will appear (if it doesn't, click "Roaming").
#Click the "Roaming" item that appears on the  menu.  
#In the Windows Explorer window, choose Mozilla &rarr; Thunderbird &rarr; Profiles. Each folder in this folder is a profile on your computer.
#In the Windows Explorer window that opens, choose Thunderbird &rarr; Profiles. Each folder in this folder is a profile on your computer.
 
You can also navigate directly to your profile folder at the following path:
* ''C:\Users\''<Windows user name>''\AppData\Roaming\Thunderbird\Profiles\<Profile name>\''
 
...or by using Thunderbird menu path Help->Troubleshooting information->click on the "Show Folder" button.


You can also navigate directly to your folder at the path <tt>C:\Users\<Windows user name>\AppData\Roaming\Thunderbird\Profiles\<Profile name>\</tt> . The AppData folder is folder is a hidden folder; to show hidden folders, open Windows Explorer and choose "Organize &rarr; Folder and Search Options &rarr; Folder Options &rarr; View (tab) &rarr; Show hidden files and folders".
The AppData folder is folder is a hidden folder; to show hidden folders, open a Windows Explorer window and choose "Organize &rarr; Folder and Search Options &rarr; Folder Options &rarr; View (tab) &rarr; Show hidden files and folders".


===Linux and Unix===
===Linux and Unix===


Profile folders are in <tt>~/.thunderbird/<Profile name>/</tt> . However, if you're using a third party build from Debian or Ubuntu they store it in <tt>~/.mozilla-thunderbird<Profile name></tt>. Both are hidden folders. To show hidden folders in Nautilus (Gnome desktop's default file browser), choose View -> Show Hidden Files.
Profile folders are located here:
* ''~/.thunderbird/<Profile name>/''
However, if you're using a third party build from Debian or Ubuntu,  those builds store your profile folder here:
* ''~/.mozilla-thunderbird<Profile name>''.  
Both are hidden folders. See [[show hidden files and folders#Linux|this article]] for more information.  To show hidden files in Nautilus (Gnome desktop's default file browser), choose "View -> Show Hidden Files".


===Mac OS X===
===Mac OS X===


Profile folders are in <tt>~/Library/Thunderbird/Profiles/<Profile name>/</tt>, <tt>~/Library/Application Support/Thunderbird/Profiles/<Profile name>/</tt>, or <tt>/Users/<user name>/Library/Thunderbird/Profiles/<Profile name>/</tt> .
Profile folders are located here:
* ''~/Library/Thunderbird/Profiles/<Profile name>/''
The tilde character (~) refers to the current user's Home folder, so ''~/Library'' is the  ''/Macintosh HD/Users/<username>/Library'' folder.


===Other methods of finding a profile===
===Other methods of finding a profile===
====Searching for a file====
Every Thunderbird (or SeaMonkey) profile will have an "abook.mab" file, even if you've configured it to [[Moving_your_mail_storage_location_-_Thunderbird | store messages outside of the profile]]. You could find a profile by doing a file search for that file. However, you need to [[Show hidden files and folders#Searching for a file|include hidden files and folders in the search]]:
* Windows 2000:  In Windows Explorer (or My Computer) choose Tools &rarr; Folder Options &rarr; View (tab) &rarr; Show hidden files and folders
* Windows XP:  Click "Start &rarr; Search".  In the Search Results window, scroll down and click "More advanced options".  Check the boxes,  "Search system folders", "Search hidden files and folders" and  "Search subfolders"
* Windows Vista:  From the Windows Start menu, click "Search".  In the "Advanced Search" area, select "Include non-indexed, hidden, and system files (might be slow)"


Every Thunderbird (or SeaMonkey) profile with have a abook.mab file, even if you've configured it to [[Moving_your_mail_storage_location_-_Thunderbird | store messages outside of the profile]]. You could find a profile by doing a file search for that file. However, you need to include hidden files and folders in the search.
====Using the Error Console====
 
You can also use Thunderbird to find the location of whatever profile it is using.  In Thunderbird, go to "Tools -> Error Console" and then copy and paste the following code in the field near the top of the Error Console and click on the Evaluate button.  It is one very long line ending in ''path'' &mdash; make sure that you get all of it:
{{Right-pic|FolderOptions.png}}
 
* Windows 2000: In Windows Explorer, choose Tools &rarr; Folder Options &rarr; View (tab) &rarr; Show hidden files and folders
* Windows XP: Within the search tool, More Advanced Options &rarr; Search hidden files and folders
* Windows Vista: Within the search tool, More Advanced Options &rarr; Include non-indexed, hidden or system files
 
You can also use Thunderbird to find the location of whatever profile it is using.  Copy and paste the following code in the field near the top of "Tools -> Error Console" and click on the Evaluate button.  It is one very long line ending in <tt>path</tt> &mdash; make sure that you get all of it:
 
:<code>Components.classes["@mozilla.org/file/directory_service;1"].getService( Components.interfaces.nsIProperties).get("ProfD", Components.interfaces.nsIFile).path</code>
:<code>Components.classes["@mozilla.org/file/directory_service;1"].getService( Components.interfaces.nsIProperties).get("ProfD", Components.interfaces.nsIFile).path</code>


Line 72: Line 81:
!Description
!Description
|-
|-
| <tt>Attachments</tt>
| Attachments
| Used when attachments aren't stored in the folder or the desktop.   
| Used when attachments aren't stored in the folder or the desktop.  It may not exist as the settings for where attachments should be stored are frequently ignored.
|-
|-
|<tt>[[chrome folder|chrome]]</tt>  
| calendar-data  
| Its mainly used for the optional [[userChrome.css]] and [[userContent.css]] files.
| Used by the [https://addons.mozilla.org/en-US/thunderbird/addon/2313 Lightning] extension.
|-
|-
| <tt>extensions</tt>
| Cache 
| Used by the optional disk cache added in Thunderbird 3.0
|-
| crashes 
|
|-
|[[chrome folder|chrome]] 
| Optional. Mainly used for the optional [[userChrome.css]] and [[userContent.css]] files.
|-
| extensions
| Installed extensions and themes.  
| Installed extensions and themes.  
|-
|-
| <tt>ImapMail</tt>
| ImapMail
| Mail from IMAP accounts.  
| Mail from [[IMAP]] accounts.
|-
| lwtheme
| Another directory used by personas (light weight themes).
|-
| Mail
| Contains subfolders with:<br>- POP accounts and pop mail storage. They're normally named after the mail server so if you had a Gmail POP account it would use a pop.gmail.com subdirectory<br>- Local Folders mail storage (including [[Global Inbox]])<br>- Feeds or News & Blogs for RSS subscriptions and feeds<br>- smart mailboxes for Unified Folders/Smart Folders (virtual folders). It's typically called "smart mailboxes -1"
|-
| minidumps
| Dump files (*.dmp) created by the [[Breakpad | crash reporter]]
|-
| News
| News accounts and newsgroups
|-
| OfflineCache 
| "app cache" according to the [https://addons.mozilla.org/en-US/thunderbird/addon/more-about/?src=ss More About] add-on..
|-
| safebrowsing 
|
|-
| personas 
| Stores light weight themes (personas). Used by the [https://addons.mozilla.org/en-US/thunderbird/addon/personas-plus/ Personas Plus] add-on. It requires Thunderbird 3.0 or later
|-
|-
| searchplugins 
| Optional. Used if you added additional search provider such as DuckDuckGo to OpenSearch.
|-
| startupCache 
| Precompiled startup cache stored in a startupCache.4.little file. Not clear what it caches other than system font data but some Firefox add-on developers delete the equivalent file in a Firefox profile while developing add-ons.  [https://bugzilla.mozilla.org/show_bug.cgi?id=593349][https://bugzilla.mozilla.org/show_bug.cgi?id=600713][http://groups.google.com/group/mozilla.dev.extensions/browse_thread/thread/1ccd86340965fda5]
|-
|-
| <tt>Mail</tt>
| TestPilotExperimentFiles 
| Mail from POP accounts and Local Folders (Global Inbox)
| Obsolete. Used by the optional [https://addons.mozilla.org/en-us/thunderbird/addon/test-pilot-for-thunderbird/ TestPilot] add-on. It runs user studies on how Thunderbird is used, and is used to submit answers to surveys. It requires Thunderbird 8.0 or later.
|-
|-
| <tt>News</tt>
| WebmailData
| News from newsgroups
| Obsolete. Used by the [http://webmail.mozdev.org/ Webmail] extension.
|}
|}


All of the messages for an account are stored in a subdirectory named after the mail server. For example if you have a Gmail POP account it would create a pop.gmail.com subdirectory in Mail. Your messages would be stored in  text files with the folders name and no file extension called mbox files.  For example, the inbox folder would be called "Inbox.". There would  also be a inbox.msf file (a index file, it doesn't have any messages) and there might be a inbox.sbd subdirectory. The .sbd subdirectories are used to store the folders in a hierarchy, there is no master list describing how the folders should be organized.
All of the messages for an account are stored in a subdirectory named after the mail server. For example if you have a Gmail POP account it would create a pop.gmail.com subdirectory in Mail. Your messages would be stored in  text files with names of the folders shown in Thunderbird and with no file extension called mbox files.  For example, the inbox folder would be called "Inbox.". There would  also be a inbox.msf file (a index file, it doesn't have any messages) and there might be a inbox.sbd subdirectory. The .sbd subdirectories are used to store the folders in a hierarchy, as there is no master list describing how the folders should be organized.
 
If you use a add-on to make a [[Using_webmail_with_your_email_client | webmail account]] emulate a POP account the mail server is typically 127.0.0.1 (or localhost). If you have more than one account with the same mail server Thunderbird adds a suffix. So your second yahoo webmail account might be stored in 127.0.0.1-1. The same thing occurs if you have multiple accounts with the same POP or IMAP servers, though thats less common.


If you use a add-on to make a [[Using_webmail_with_your_email_client | webmail account]] emulate a POP account the mail server is typically 127.0.0.1 (or localhost). If you have more than one account with the same mail server Thunderbird adds a suffix. So your second yahoo webmail account might be stored in 127.0.0.1-1. The same thing occurs if you have multiple accounts with the same POP or IMAP servers, though thats less common.
===Files===
===Files===
None of these files should be read-only. If they are that might be a side effect of dragging and dropping or backing up files to removable media, and then using them to restore your profile.


See [[Files and folders in the profile - Thunderbird]] for a more complete list.
See [[Files and folders in the profile - Thunderbird]] for a more complete list.
Line 103: Line 151:
! Description
! Description
|-
|-
| <tt>abook.mab</tt>
| abook.mab
| Personal Address Book
| Personal Address Book
|-
|-
| <tt>cert8.db</tt>
| cert8.db
| Security certificates
| Security certificates
|-
|-
| <tt>[[cookies.txt]]</tt>
| [[cookies.txt]]
| [[Cookies]] [[RSS_cookies_%28Thunderbird%29]]
| [[Cookies]] [[RSS_cookies_%28Thunderbird%29]]
|-
|-
| <tt>[[downloads.rdf]]</tt>
| [[downloads.rdf]]
| Download history.  Can be deleted to resolve slow downloads or program hangs ([https://bugzilla.mozilla.org/show_bug.cgi?id=159107 Bug 159107])
| Download history.  Can be deleted to resolve slow downloads or program hangs ([https://bugzilla.mozilla.org/show_bug.cgi?id=159107 Bug 159107])
|-
|-
| <tt>extensions.rdf</tt>
| extensions.rdf
| Installed extension information.  It can be [[Uninstalling_extensions | deleted]] to remove "ghost" entries from the extension list [https://bugzilla.mozilla.org/show_bug.cgi?id=319022] and to resolve various other issues.
| Installed extension information.  It can be [[Uninstalling_extensions | deleted]] to remove "ghost" entries from the extension list [https://bugzilla.mozilla.org/show_bug.cgi?id=319022] and to resolve various other issues.
|-
|-
| <tt>history.mab</tt>
| history.mab
| Collected addresses
| Collected addresses
|-
|-
| <tt>[[key3.db]]</tt>
| [[key3.db]]
| Key database
| Key database
|-
|-
| <tt>[[localstore.rdf]]</tt>
| [[localstore.rdf]]
| Toolbar and [[Window_layout_-_Thunderbird window]] size/position settings.  It can be deleted to resolve various issues.
| Toolbar and [[Window_layout_-_Thunderbird|window layout]] size/position settings.  It can be deleted to resolve various issues. '''(Replaced by xulstore.json in latest versions of Thunderbird.)'''
|-
|-
| <tt>mailviews.dat</tt>
| mailviews.dat
| Defines your current message view (you can customize it)  
| Defines your current message view (you can customize it)  
|-
|-
| <tt>[[mimeTypes.rdf]]</tt>
| [[mimeTypes.rdf]]
| Action to perform when downloading certain types of files.  Can be deleted to reset download actions.
| Action to perform when downloading certain types of files.  Can be deleted to reset download actions.
|-
|-
| <tt>msgFilterRules.dat</tt> in <tt>ImapMail</tt>, <tt>Mail</tt>, <tt>News</tt>
| msgFilterRules.dat in ImapMail, Mail, News
| [[Filters (Thunderbird)|Message filters]]
| [[Filters (Thunderbird)|Message filters]]
|-
|-
| <tt>panacea.dat</tt>
| panacea.dat
| Mail folder cache. Deleting it sometimes helps get rid of [[Phantom folders]]
| Mail folder cache. Deleting it sometimes helps get rid of [[Phantom folders]]
|-
|-
| <tt>[[popstate.dat]]</tt> in Mail
| [[popstate.dat]] in Mail
| Keeps track of which messages have been downloaded and left on the POP3 server
| Keeps track of which messages have been downloaded and left on the POP3 server
|-
|-
| <tt>[[prefs.js file|prefs.js]]</tt>
| [[prefs.js file|prefs.js]]
| All preferences. See: [[Modify Thunderbird settings]]
| All non-default preferences. See: [[Modify Thunderbird settings]]
|-
|-
| <tt>secmod.db</tt>
| secmod.db
| Security module database
| Security module database
|-
|-
| <tt>[[signons.txt]]</tt>
| signons.sqlite
| Encrypted saved passwords, requires <tt>key3.db</tt> to work . The signon.SignonFileName setting specifies this file.
| Encrypted saved passwords, requires key3.db to work. It used to use signons.txt or signons3.txt.  
|-
|-
| <tt>training.dat</tt>
| training.dat
| Custom training for [[Junk Mail Controls]]
| Custom training for [[Junk Mail Controls]]
|-
|-
| <tt>[[user.js]]</tt><br>(does not exist by default)
| [[user.js]]<br>(does not exist by default)
| User-set overriding preferences
| User-set overriding preferences
|}
|}
Line 163: Line 211:
! Description
! Description
|-
|-
| <tt>*.</tt> in <tt>ImapMail</tt>, <tt>Mail</tt>, and <tt>News</tt>
| *. in ImapMail, Mail, and News
| [[Importing_and_exporting_your_mail#Mbox_files | Mbox files]]. They are text files that contain all of the messages for that folder.
| [[Importing_and_exporting_your_mail#Mbox_files | Mbox files]]. They are text files that contain all of the messages for that folder.
|-
|-
| <tt>*.mab</tt> other than <tt>abook.mab</tt> and <tt>history.mab</tt>
| *.mab other than abook.mab and history.mab
| User-created or imported address books.  
| User-created or imported address books.  
|-
|-
| <tt>*.msf</tt> in <tt>ImapMail</tt>, <tt>Mail</tt>, and <tt>News</tt>
| *.msf in ImapMail, Mail, and News
| Index files for mail messages.  
| Index files for mail messages. Playback information for offline operations and incomplete online operations.  
|}
|}
==Portable Thunderbird==
[http://portableapps.com/apps/internet/thunderbird_portable Portable Thunderbird] is a popular third party build of Thunderbird that is installed on a USB drive along with the profile. It's designed for roaming users. The profile is not specified by a profiles.ini file on the boot disk, it's always in a Data\profile directory within the programs directory. It can have only one profile and doesn't support the profile manager.
The profile has the same layout and files as Thunderbird.
==Miscellaneous information==
The channel-prefs.js file in the defaults\pref directory in the Thunderbird program directory
specifies what update channel you are using. That determines what type of builds auto-update looks for. [[app.update.channel]] is normally set to "release". If you installed a beta that would set it to "beta". If you want to stop getting beta and release candidate updates change it to "release".
The application.ini file was added to the Thunderbird program directory with Thunderbird 3.0. It's mainly used to control whether the migration assistant , crash reporter and extension manager are enabled.
The mailviews.dat file in the defaults\messenger directory in the Thunderbird program directory specifies the default custom views. Views are selected using the View list box in the toolbar. You can add it to the toolbar by right clicking on the toolbar, selecting customize, dragging and dropping the View control to the toolbar and pressing the Done button.
Icons are normally available both as a resource within Thunderbird and at
chrome/icons/default/messengerWindow.ico in the program directory. If you don't like the icon in the current version you could copy that file from an [ftp://ftp.mozilla.org/pub/mozilla.org/thunderbird/releases/ older version] and modify the shortcut to point to it.


==See also==
==See also==
Line 177: Line 242:
* [[Profile_backup | Profile backup]]
* [[Profile_backup | Profile backup]]
* [[Protecting_the_contents_of_the_profile_-_mail | Protecting the contents of the profile]]
* [[Protecting_the_contents_of_the_profile_-_mail | Protecting the contents of the profile]]
* [[Move a profile to Portable Thunderbird]]
* [[Moving_your_profile_folder]]
* [[Recovering_a_profile_that_suddenly_disappeared | Recovering a profile that suddenly disappeared]]
* [[Recovering_a_profile_that_suddenly_disappeared | Recovering a profile that suddenly disappeared]]
* [[Sharing_a_profile_between_Windows_and_Linux | Sharing a profile between Windows and Linux]]
* [[Sharing_a_profile_between_Windows_and_Linux | Sharing a profile between Windows and Linux]]
Line 185: Line 252:
* [http://www.mozilla.org/support/thunderbird/profile Mozilla's web page on how to manage Thunderbird profiles]
* [http://www.mozilla.org/support/thunderbird/profile Mozilla's web page on how to manage Thunderbird profiles]
* [https://bugzilla.mozilla.org/show_bug.cgi?id=247973 Bug report] about profiles should be stored under "Mozilla/Thunderbird" not "Thunderbird"
* [https://bugzilla.mozilla.org/show_bug.cgi?id=247973 Bug report] about profiles should be stored under "Mozilla/Thunderbird" not "Thunderbird"
* [http://postbox.zendesk.com/entries/69230-postbox-profile-data Postbox profile locations]
[[Category:Profiles]]
[[Category:Profiles]]

Latest revision as of 13:33, 24 March 2018

This article is about Thunderbird's profile folder. See also Profile folder - Firefox and Profile folder - SeaMonkey.

Thunderbird stores all personal data such as messages, address books and configuration settings in an OS folder called the profile. A profile can contain one or more account for mail, RSS, news, etc. The first time you start Thunderbird it will automatically create a profile in a default location if it does not already exist. You can also use the Profile Manager to create a profile wherever you want (but don't create it in the Thunderbird program directory) or to delete or rename one.

It is a good idea to periodically backup your profile to a safe location. Thunderbird doesn't delete a profile when uninstalling, upgrading or re-installing (it is stored in a directory outside of your program directory), but to avoid any risk of accidentally affecting or deleting it as a side effect of an update it is a good idea to back it up before taking such actions.

Thunderbird does not let you switch profiles without exiting, unlike Outlook Expresses identities. However, the profile switcher extension will let you switch profiles.

Finding your profile

Profile folders default to a standard location but are named randomly for additional security. You can set a custom location using other methods mentioned below.

The installation directory includes a folder named "profile" (for example, C:\Program Files\Mozilla Thunderbird\defaults\profile on Windows), but this folder contains program defaults, not your user profile data. On Windows 2000/XP/Vista and on Linux, the folder containing your user profile data is hidden by default and you will need to show hidden files and folders to navigate to the profile folder.

The easiest way to find your profile is to click on the "Show Folder" button in Help -> Troubleshooting Information. That launches windows explorer (or the equivalent file manager for your operating system) with the profile folder selected. That feature was added in Thunderbird 5.0.

Windows 2000 and XP

  1. Choose Start → Run
  2. Type in %APPDATA%
  3. Press OK. A Windows Explorer window will appear.
  4. In the Windows Explorer window, choose Thunderbird → Profiles. Each folder in this folder is a profile on your computer.

You can also navigate directly to your profile folder at the following path:

  • C:\Documents and Settings\<Windows user name>\Application Data\Thunderbird\Profiles\<Profile name>

The Application Data folder is a hidden folder; to show hidden folders, open Windows Explorer and choose "Tools → Folder Options → View (tab) → Show hidden files and folders".

Windows Vista, 7, 8.1 and 10

  1. Open the Windows Start menu
  2. In the the "Start Search" box, type in %APPDATA% [1]
  3. Click the "Roaming" item that appears on the menu.
  4. In the Windows Explorer window that opens, choose Thunderbird → Profiles. Each folder in this folder is a profile on your computer.

You can also navigate directly to your profile folder at the following path:

  • C:\Users\<Windows user name>\AppData\Roaming\Thunderbird\Profiles\<Profile name>\

...or by using Thunderbird menu path Help->Troubleshooting information->click on the "Show Folder" button.

The AppData folder is folder is a hidden folder; to show hidden folders, open a Windows Explorer window and choose "Organize → Folder and Search Options → Folder Options → View (tab) → Show hidden files and folders".

Linux and Unix

Profile folders are located here:

  • ~/.thunderbird/<Profile name>/

However, if you're using a third party build from Debian or Ubuntu, those builds store your profile folder here:

  • ~/.mozilla-thunderbird<Profile name>.

Both are hidden folders. See this article for more information. To show hidden files in Nautilus (Gnome desktop's default file browser), choose "View -> Show Hidden Files".

Mac OS X

Profile folders are located here:

  • ~/Library/Thunderbird/Profiles/<Profile name>/

The tilde character (~) refers to the current user's Home folder, so ~/Library is the /Macintosh HD/Users/<username>/Library folder.

Other methods of finding a profile

Searching for a file

Every Thunderbird (or SeaMonkey) profile will have an "abook.mab" file, even if you've configured it to store messages outside of the profile. You could find a profile by doing a file search for that file. However, you need to include hidden files and folders in the search:

  • Windows 2000: In Windows Explorer (or My Computer) choose Tools → Folder Options → View (tab) → Show hidden files and folders
  • Windows XP: Click "Start → Search". In the Search Results window, scroll down and click "More advanced options". Check the boxes, "Search system folders", "Search hidden files and folders" and "Search subfolders"
  • Windows Vista: From the Windows Start menu, click "Search". In the "Advanced Search" area, select "Include non-indexed, hidden, and system files (might be slow)"

Using the Error Console

You can also use Thunderbird to find the location of whatever profile it is using. In Thunderbird, go to "Tools -> Error Console" and then copy and paste the following code in the field near the top of the Error Console and click on the Evaluate button. It is one very long line ending in path — make sure that you get all of it:

Components.classes["@mozilla.org/file/directory_service;1"].getService( Components.interfaces.nsIProperties).get("ProfD", Components.interfaces.nsIFile).path

The console should display the location of the profile that is currently in use. If you don't see it, select "All" in the toolbar.

Profiles.ini

Thunderbird uses the profiles.ini file to find the location of your profiles, and to determine which profile is the default profile. If you're using Windows the file is located in the parent of the "Profiles" folder. It can be edited to move your profile. If it's deleted, a new profiles.ini file will be created and a new default profile folder created when Thunderbird starts.

This file is the reason why you can't just copy a profile into the "profiles" folder and have Thunderbird discover it.

Files and folders in the profile

Folders

Name Description
Attachments Used when attachments aren't stored in the folder or the desktop. It may not exist as the settings for where attachments should be stored are frequently ignored.
calendar-data Used by the Lightning extension.
Cache Used by the optional disk cache added in Thunderbird 3.0
crashes
chrome Optional. Mainly used for the optional userChrome.css and userContent.css files.
extensions Installed extensions and themes.
ImapMail Mail from IMAP accounts.
lwtheme Another directory used by personas (light weight themes).
Mail Contains subfolders with:
- POP accounts and pop mail storage. They're normally named after the mail server so if you had a Gmail POP account it would use a pop.gmail.com subdirectory
- Local Folders mail storage (including Global Inbox)
- Feeds or News & Blogs for RSS subscriptions and feeds
- smart mailboxes for Unified Folders/Smart Folders (virtual folders). It's typically called "smart mailboxes -1"
minidumps Dump files (*.dmp) created by the crash reporter
News News accounts and newsgroups
OfflineCache "app cache" according to the More About add-on..
safebrowsing
personas Stores light weight themes (personas). Used by the Personas Plus add-on. It requires Thunderbird 3.0 or later
searchplugins Optional. Used if you added additional search provider such as DuckDuckGo to OpenSearch.
startupCache Precompiled startup cache stored in a startupCache.4.little file. Not clear what it caches other than system font data but some Firefox add-on developers delete the equivalent file in a Firefox profile while developing add-ons. [2][3][4]
TestPilotExperimentFiles Obsolete. Used by the optional TestPilot add-on. It runs user studies on how Thunderbird is used, and is used to submit answers to surveys. It requires Thunderbird 8.0 or later.
WebmailData Obsolete. Used by the Webmail extension.

All of the messages for an account are stored in a subdirectory named after the mail server. For example if you have a Gmail POP account it would create a pop.gmail.com subdirectory in Mail. Your messages would be stored in text files with names of the folders shown in Thunderbird and with no file extension called mbox files. For example, the inbox folder would be called "Inbox.". There would also be a inbox.msf file (a index file, it doesn't have any messages) and there might be a inbox.sbd subdirectory. The .sbd subdirectories are used to store the folders in a hierarchy, as there is no master list describing how the folders should be organized.

If you use a add-on to make a webmail account emulate a POP account the mail server is typically 127.0.0.1 (or localhost). If you have more than one account with the same mail server Thunderbird adds a suffix. So your second yahoo webmail account might be stored in 127.0.0.1-1. The same thing occurs if you have multiple accounts with the same POP or IMAP servers, though thats less common.

Files

None of these files should be read-only. If they are that might be a side effect of dragging and dropping or backing up files to removable media, and then using them to restore your profile.

See Files and folders in the profile - Thunderbird for a more complete list.

Name Description
abook.mab Personal Address Book
cert8.db Security certificates
cookies.txt Cookies RSS_cookies_(Thunderbird)
downloads.rdf Download history. Can be deleted to resolve slow downloads or program hangs (Bug 159107)
extensions.rdf Installed extension information. It can be deleted to remove "ghost" entries from the extension list [5] and to resolve various other issues.
history.mab Collected addresses
key3.db Key database
localstore.rdf Toolbar and window layout size/position settings. It can be deleted to resolve various issues. (Replaced by xulstore.json in latest versions of Thunderbird.)
mailviews.dat Defines your current message view (you can customize it)
mimeTypes.rdf Action to perform when downloading certain types of files. Can be deleted to reset download actions.
msgFilterRules.dat in ImapMail, Mail, News Message filters
panacea.dat Mail folder cache. Deleting it sometimes helps get rid of Phantom folders
popstate.dat in Mail Keeps track of which messages have been downloaded and left on the POP3 server
prefs.js All non-default preferences. See: Modify Thunderbird settings
secmod.db Security module database
signons.sqlite Encrypted saved passwords, requires key3.db to work. It used to use signons.txt or signons3.txt.
training.dat Custom training for Junk Mail Controls
user.js
(does not exist by default)
User-set overriding preferences

Files without specific names

Name Description
*. in ImapMail, Mail, and News Mbox files. They are text files that contain all of the messages for that folder.
*.mab other than abook.mab and history.mab User-created or imported address books.
*.msf in ImapMail, Mail, and News Index files for mail messages. Playback information for offline operations and incomplete online operations.

Portable Thunderbird

Portable Thunderbird is a popular third party build of Thunderbird that is installed on a USB drive along with the profile. It's designed for roaming users. The profile is not specified by a profiles.ini file on the boot disk, it's always in a Data\profile directory within the programs directory. It can have only one profile and doesn't support the profile manager.

The profile has the same layout and files as Thunderbird.

Miscellaneous information

The channel-prefs.js file in the defaults\pref directory in the Thunderbird program directory specifies what update channel you are using. That determines what type of builds auto-update looks for. app.update.channel is normally set to "release". If you installed a beta that would set it to "beta". If you want to stop getting beta and release candidate updates change it to "release".

The application.ini file was added to the Thunderbird program directory with Thunderbird 3.0. It's mainly used to control whether the migration assistant , crash reporter and extension manager are enabled.

The mailviews.dat file in the defaults\messenger directory in the Thunderbird program directory specifies the default custom views. Views are selected using the View list box in the toolbar. You can add it to the toolbar by right clicking on the toolbar, selecting customize, dragging and dropping the View control to the toolbar and pressing the Done button.

Icons are normally available both as a resource within Thunderbird and at chrome/icons/default/messengerWindow.ico in the program directory. If you don't like the icon in the current version you could copy that file from an older version and modify the shortcut to point to it.

See also

External links