> For the complete documentation index, see [llms.txt](https://help.brieftech.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.brieftech.ai/how-to-guides/process/extract-zip-attachments.md).

# Extract files from a ZIP or email attachment

Unpack the contents of a ZIP archive or email's attachments into separate documents in your matter.

First, open the matter and go to the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-30913153ebd9cc9194606c644922feb649ae10a5%2Ftab-files.svg?alt=media" alt="Files tab" data-size="line"> tab. You need edit access to the matter — you must be its **Owner** or an **Editor**.

## Find files that are ready to extract

In the left panel under **Views**, select <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-3b89c9cf0a95785d2178ec1beac7b22623d7d24b%2Fview-extractable.svg?alt=media" alt="Extractable" data-size="line">. A file is extractable when it contains embedded files — a `.zip` archive, or a `.msg`/`.eml` email with attachments — and has not yet been extracted; this view shows only those.

## Extract the files

1. Select one or more files in the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-3b89c9cf0a95785d2178ec1beac7b22623d7d24b%2Fview-extractable.svg?alt=media" alt="Extractable" data-size="line"> view. You can select multiple files to extract them all at once.
2. In the toolbar, click <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-fb17fb128702c73ac3267d6a4e2b0a55b09cef2d%2Ficon-unarchive.svg?alt=media" alt="Extract ZIP &#x26; Attachments" data-size="line">. It appears as an icon; hover it to see how many of your selected files are eligible — its tooltip reads, for example, **Extract ZIP & Attachments (3)**.
3. BriefTech unpacks the contents and creates a new document for each embedded file, linked to the source file as its parent.

{% hint style="warning" %}
**Decide which extraction you want before you run either one.** There is a second extract action, *Extract Attachments Only*, which unpacks only genuine attachments and leaves out images embedded in an email's body — useful when a signature logo or an inline screenshot would otherwise arrive as its own document. Both actions use the file's single extraction, so whichever you run first is the one you get: the other stops appearing for that file, and there is no way to run it afterwards.
{% endhint %}

{% hint style="info" %}
**Other ways to reach either extract action:**

* Right-click the selected file(s) and choose the action from the menu.
* Neither action is limited to the Extractable view — the toolbar buttons and the right-click items appear in any Files-tab view, and on the Review tab. The Extractable view above is simply the easiest way to find the files.
* Both are hidden, not greyed out, when none of the selected files still has embedded contents to unpack.
  {% endhint %}

## Extract only the attachments

When the source is an email, a second action unpacks **only its genuine attachments** and leaves out images embedded in the message body — a signature logo, an inline screenshot, or a tracking pixel that would otherwise each arrive as its own document.

1. Select one or more eligible files in the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-3b89c9cf0a95785d2178ec1beac7b22623d7d24b%2Fview-extractable.svg?alt=media" alt="Extractable" data-size="line"> view.
2. In the toolbar, click <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-11de5082b7ba45652ce91cebd427990eb976d5a9%2Ficon-extract-attachments.svg?alt=media" alt="Extract Attachments Only" data-size="line">. It appears as an icon; hover it to see its name, *Extract Attachments Only*, followed by a count of how many of your selected files are eligible.
3. BriefTech creates a new document for each attachment, linked to the source file as its parent. Images embedded in an email's body are skipped, so an email whose only embedded content is inline images produces nothing.

{% hint style="info" %}
**Which one to pick.** For a ZIP archive the two actions do the same thing — a ZIP has no message body, so there are no inline images to leave out. The difference only matters for emails: use *Extract Attachments Only* when you want the genuine attachments without the sender's inline graphics.
{% endhint %}

## Large batches

If the total size of the selected files comes to more than about 10.5 MB — the sizes BriefTech shows in the **Size** column, added together — extraction runs as a background job. A progress dialog opens automatically — you can close it and continue working; the job continues in the background. You can track its progress in the [Background Jobs](/reference/background-jobs.md) panel.

## After extraction

Each extracted file appears as an individual document in the matter. It inherits the same folder as its source file and is linked to it as a child document. The extracted files then process independently, like any newly added document — see [Document processing and errors](/reference/document-processing-and-errors.md).

The source file remains in the matter and is marked as extracted.

{% hint style="info" %}
**Extraction is free — you are billed only when you index or export the extracted files.** Each extracted file becomes a standard document in the matter and consumes credits like any other, so unpacking a large archive adds to the documents you may be billed for later.
{% endhint %}

## Related

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Supported file formats</strong></td><td>Which file types can contain embedded files.</td><td><a href="/reference/supported-file-formats.md">Supported file formats</a></td></tr><tr><td><strong>Embedded file extraction</strong></td><td>How detection and extraction work.</td><td><a href="/reference/embedded-file-extraction.md">Embedded file extraction</a></td></tr><tr><td><strong>Background Jobs</strong></td><td>Track extraction progress for large batches.</td><td><a href="/reference/background-jobs.md">Background Jobs</a></td></tr></tbody></table>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.brieftech.ai/how-to-guides/process/extract-zip-attachments.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
