> 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/unlock-password-protected-file.md).

# Unlock a password-protected file

Decrypt a password-protected file so BriefTech can process it.

To get a password-protected file into BriefTech, remove its protection outside the app first:

1. Open the file with its password, in a PDF reader or the app that created it.
2. Remove the protection:
   * **PDF** — save or print it to a new, unprotected PDF, or clear the password in the document's security settings.
   * **Word, Excel or PowerPoint** — open it with the password and save a copy with the encryption removed.
   * **ZIP archive** — extract the contents with the password, then upload the extracted files.
3. Upload the unprotected copy to BriefTech.

This applies only to a file that cannot be opened at all: BriefTech does not ask you for a document password, so such a file stops with an error and is flagged as **Password Protected** in the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-37d644760a5ee6e01339e95d7c53eb14f0b99bb4%2Fview-exceptions.svg?alt=media" alt="Exceptions" data-size="line"> view. A file that is merely *restricted* — a PDF that opens without a password but blocks printing or copying, or a Word file marked read-only — is not affected and processes normally.

{% hint style="info" %}
**Retrying will not help.** **Retry All** and **Retry Selected** in the Exceptions view re-run the file from the beginning, exactly as it was uploaded — the protection is still there and no password is supplied on retry, so it stops again at the same point. (**Skip PDF Conversion** does not appear for these files; it only applies to files that failed during PDF conversion, not at the password check.) Replacing the file with an unprotected copy is the only fix.
{% endhint %}

See [Document processing and errors](/reference/document-processing-and-errors.md).

## If you leave the file protected

The file stays in the matter but is never converted. If you build a court bundle that includes it, BriefTech warns you first — listing it under **Password-protected**, with a note that a placeholder page will appear in its place — and, if you continue, inserts a single placeholder page, labelled with the file name and reading *"This document is password-protected and could not be included."*

The unprotected copy you upload in its place processes like any other upload.

## 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>The document lifecycle: from upload to ready</strong></td><td>What happens to a file between upload and the moment it can be used.</td><td><a href="/concepts/the-document-lifecycle.md">The document lifecycle: from upload to ready</a></td></tr><tr><td><strong>Reprocess a failed document</strong></td><td>Re-run a document through the processing pipeline after it failed.</td><td><a href="/how-to-guides/process/reprocess-failed-document.md">Reprocess a failed document</a></td></tr><tr><td><strong>Background Jobs</strong></td><td>Status indicators, columns, and row actions in the Background Jobs dialog.</td><td><a href="/reference/background-jobs.md">Background Jobs</a></td></tr><tr><td><strong>Extract files from a ZIP or email attachment</strong></td><td>Unpack the contents of a ZIP archive or email's attachments into separate documents in your matter.</td><td><a href="/how-to-guides/process/extract-zip-attachments.md">Extract files from a ZIP or email attachment</a></td></tr><tr><td><strong>Document processing and errors</strong></td><td>Processing stages, what OCR reads, and the document error reasons.</td><td><a href="/reference/document-processing-and-errors.md">Document processing and errors</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/unlock-password-protected-file.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.
