Pro

Email is an important item in many situations, both professional and personal. Imported email messages are saved in their original, uneditable file format (`.eml`) and are displayed using QuickLook or as an text alternative view. Some metadata, e.g., the "read" and "flagged" status of email messages will be preserved, when possible. Take some time to review the Files > Emails settings as well as a breakdown of the interface in the Sidebar: Email section of this document.

To address the need to store and search for emails, and to work around limitations of some email clients, DEVONthink supports several methods of importing emails. Let's look at the options…

## Import to DEVONthink

Importing emails from Apple Mail or Microsoft Outlook can be done directly in DEVONthink.

1. Open the Import sidebar: Open the View > Import sidebar.

2. Select the email application: Open the appropriate email client, Apple Mail or Microsoft Outlook in the Emails section on the left.

3. Choose a mailbox: Select the desired mailbox. DEVONthink will communicate with the email application and begin building a list of available emails in the mailbox. Building this list takes more time with larger numbers of unimported emails.

4. Choose where to import: Choose or verify the target database in the Destination dropdown.

5. Archive the mailbox or import emails: Press the Archive button to archive the entire mailbox or select some emails and press the Import button. Repeat with other emails or mailboxes, as needed.

When you need to import emails while in DEVONthink, return to this sidebar and import or archive again. Also, don't forget the suite of controls on the right hand side are available to filter down to specific emails, e.g., from a particular person.

Import or Archive: When it comes to archiving email, the question arises: "Do I use import or archive?" Here's the simple way to understand it:

- Import Email: While Import can be used on a mailbox, it is generally used on selected, individual emails. This is especially useful when using a filtered view, e.g., filtering by a date range or recipient. You'd select those files and use the Import option. Imported emails are stored in the location selected in the Destination dropdown.
- Archive Mailbox: As the name implies, this command can only be used on selected mailboxes. The mailbox will be imported into a special Emails group at the root of the database. DEVONthink will attempt to preserve the mailbox structure shown in the email application. This is very useful for archiving a mailbox and keeping it up to date. Since previously imported emails are excluded from the mailbox view, subsequent visits to the Import sidebar will only show newly received emails. Using the Archive Mailbox option will import only those new emails into the existing Emails group in the database.

Import Via Hotkey: If you find yourself more actively working in Apple Mail or Outlook, you can archive a mailbox or selected emails with a hotkey. Set your desired key combinations in DEVONthink's Files > Emails settings. For longtime users of DEVONthink, you can set the familiar hotkeys previously used with our mail plugin: `⌥︎``⌘︎`M for messages; `⌥︎``⇧︎``⌘︎`M for mailboxes. Go to the email client, select a few emails, then press your hotkeys. They will be imported based on your preferred import destination set inFiles > Import > Destination.

Note: Due to changes made by Microsoft, the Legacy interface is required for these commands to work. If you switch from the New Outlook to Legacy, please make sure to click the `` button to let them know it's important for them to continue supporting inter-application communication on Macs.

## Other options

Here are some alternate ways for you to get emails into DEVONthink. But bear in mind, the possibilities depend on the what your email application supports, e.g., scripting.

Drag and drop: Drag to the Finder then into DEVONthink, into the Sorter, into the Global Inbox, or directly into a database.

Importing UNIX Mailboxes: UNIX mailboxes (`.mbox` files) exported from some email applications, e.g., Thunderbird, can be imported into your database. There is no mailbox structure in these exported files so multiple mailboxes have to be exported and imported separately. They can be imported into DEVONthink in one of two ways:

- File > Import: Use File > Import > UNIX Mailboxes, then select the `.mbox` file in the Open dialog and press Open. This will import the messages into a group in the current location.
- Drag and Drop: Drag and drop the `.mbox` file onto DEVONthink's dock icon to import the messages into your database.

Mail Scripts: In scriptable email applications, e.g., Apple Mail, you can run application scripts from the global Scripts menu. There are a few provided for Apple Mail and Outlook but you are free to add your own if you have another email application that supports scripting.

Mail Rule Scripts: Apple Mail rules support running AppleScripts in their mail rules. We have provided a few for you to use or modify.

## Copies and Conversations

Importing copies of emails: Briefly discussed in the Appendix, a UUID is a value given to each item in DEVONthink. It is unique to each item and more than one item can't have the same UUID. When email messages are imported, they are given such an identifier based on metadata from the actual email. This means you can't import the same message into a database more than once, as that would result in more than one file having the same UUID. When you try, the Log window will show an error about "n emails already imported".

All that being said, it's not unusual to store an email in the more than one mailbox. But an import of your mailboxes may appear to be missing some emails as the copies won't import separately. To allow for this, enable Previously imported will become replicants in the Files > Emails settings and the copies will be imported into the same database as replicants.

Conversation threading: Depending on the settings in Files > Emails > Conversations, DEVONthink can attempt to import complete conversations and optionally group them. But be aware, email threading is not an exact process. A lack of standards and decades of legacy emails can inhibit the ability to fully detect a conversation. DEVONthink will attempt to thread the conversations, but cannot guarantee all related emails will be detected.

## Replying and Sending

To reply to an archived email message in DEVONthink, select it and choose Data > Send Reply or Control-click it and choose the command from the context menu. A draft message will be composed in your default email application.

If you need to email a document to someone, select it, then choose Send by Email or Control-click it and choose the command from the context menu. This should create a draft email in your default email application with the document attached. Alternatively, many macOS applications support dropping files on their dock icon. For an email app, this usually creates a draft with the dropped file attached.

Note: The inter-application communication capabilities of the email client you are using determine how well these two commands work. If the commands aren't producing the expected results, check with the developer about what kind of interactions they allow between applications.

You can read a bit more about emails in DEVONthink in the Documents > Office Documents, Email, and Others > Email section. And if you're having issues archiving emails, please see the Troubleshooting > Email Import Issues section for assistance.