> For the complete documentation index, see [llms.txt](https://docs.cogram.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cogram.com/email/exporting-emails.md).

# Exporting emails

Download filed emails from Cogram as .eml, Outlook .msg, or PDF files.

Exporting saves one or more filed emails to your computer as standard email files (attachments included) or as PDF documents. Use exports for project closeout archives, audit trails, or sharing correspondence with contacts who are not on Cogram.

## Prerequisites

* At least one email filed in Cogram
* Email export enabled for your organization: if the **Export** button is not visible, contact your Org Admin

## Exporting a single email

1. Open [Filed Emails](https://app.cogram.com/dashboard/email-inbox) (under the **Emails** module) and select an email to preview it.
2. In the email header, select **Export**.
3. Choose a format from the dropdown:
   * **.eml**: works with most email clients (Outlook, Apple Mail, Thunderbird, Gmail import)
   * **.msg (Outlook)**: native Outlook format; best for recipients using Outlook on Windows
   * **.pdf**: a printable document that opens without an email client
4. Your browser downloads a single file named after the email subject.

## Exporting multiple emails

1. Open [Filed Emails](https://app.cogram.com/dashboard/email-inbox) under the **Emails** module.
2. Click the checkbox on any email row to start a selection. The bulk action toolbar appears at the top of the list.
   * **Select a range**: click one checkbox, hold **Shift**, then click another to select all emails in between.
   * **Select the page**: click the checkbox in the column header to select all emails on the current page.
3. Select **Export (N)** in the toolbar, where N is the number of selected emails.
4. Choose **.eml**, **.msg (Outlook)**, or **.pdf** from the dropdown.
5. Cogram packages the selected emails into a ZIP archive and downloads it.

**ZIP file name**: `{project-name}_emails_{YYYY-MM-DD}_{format}.zip`

If the selected emails span more than one project, the filename is `emails_{YYYY-MM-DD}_{format}.zip`.

## What is included

| Content                             | .eml and .msg                               | .pdf                                                           |
| ----------------------------------- | ------------------------------------------- | -------------------------------------------------------------- |
| Email body                          | Plain text and HTML                         | Text, with basic formatting                                    |
| To, From, Cc, Date, Subject headers | Always                                      | Subject always; From, To, Cc, and Date when the email has them |
| Attachments                         | When available                              | File names only                                                |
| Inline images                       | When available, linked within the HTML body | Not shown                                                      |

An `.eml` or `.msg` file is a copy of the email as received by Cogram. A PDF is a readable record of the message: it keeps the text, headings, lists, and links, lays table content out as stacked text, and lists the attachment names at the end. A PDF holds up to 500 pages of one email. Images and attachment contents are not part of the PDF, and Cogram does not load remote images or other external content when it creates one. The date in a PDF is in UTC. No AI-generated content is included.

## Choosing a format

|                   | .eml | .msg (Outlook)  | .pdf                  |
| ----------------- | ---- | --------------- | --------------------- |
| Outlook (Windows) | ✓    | ✓ native        | Opens in a PDF viewer |
| Outlook (macOS)   | ✓    | Limited support | Opens in a PDF viewer |
| Apple Mail        | ✓    | ✗               | Opens in a PDF viewer |
| Gmail import      | ✓    | ✗               | Cannot be imported    |
| Thunderbird       | ✓    | With add-on     | Opens in a PDF viewer |
| Keeps attachments | ✓    | ✓               | ✗ names only          |

Use **.eml** unless the recipient specifically requires Outlook `.msg` format. Use **.pdf** when the reader only needs to read or print the message. To keep the attachments or the original formatting, export `.eml` or `.msg` as well.

## Troubleshooting

**The Export button is not visible** Email export must be enabled for your organization. Contact your Org Admin to request access.

**A ZIP archive is missing some attachments** Attachments that could not be retrieved at export time are skipped. The email body and any other attachments are still included.

**A PDF shows plain text without formatting** When Cogram cannot lay out the formatted version of an email, or the formatted version is very large, the PDF shows the plain-text version of the message instead. It holds the start of the message, up to about 10,000 characters, and says so at the top. Export the email as `.eml` to keep the original formatting.

**A PDF says the body of the email could not be shown** Cogram could not lay out the formatted version of the email, and the email has no plain-text version. Export the email as `.eml` for the full message.

**A PDF ends with a note that it shows the first 500 pages** A PDF holds up to 500 pages of one email. Export the email as `.eml` for the full text.

**The export says it took too long** A PDF export stops after five minutes. Select fewer emails, or export as `.eml` or `.msg`.

**The export says an email could not be exported as a PDF** Export that email as `.eml` or `.msg` instead. In a bulk export, remove it from the selection and export the rest again.

**The export says another export is running, or that the selection is too large** One bulk export runs at a time. Wait a minute and try again. A bulk export holds up to 500 emails and 1 GB.

**The .msg file does not open correctly** Outlook 2016 or later on Windows is required. The macOS Outlook app has limited `.msg` file support; use `.eml` instead.

## Next steps

* [Emails](https://docs.cogram.com/email/emails.md): how to file emails and use them as source material for Agent
* [Agent](https://docs.cogram.com/agent/agent.md): summarize threads or generate reports from filed emails


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cogram.com/email/exporting-emails.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
