# Unlock a PDF File

### Overview

This procedure unlocks a password-protected PDF file. It requires the original file and the correct password. If the file is not a PDF or the password is incorrect, an error will be raised.

### Syntax

Below is a line-by-line overview of the automation syntax. Expand each line to learn more.

<details>

<summary><code>unlock the file</code></summary>

#### What does it do?

Instructs the system to unlock a password-protected PDF file.

#### Where does it go?

This phrase should be written on a **new line**.

#### Is it required?

✅ Yes — This phrase is **required**.

#### Does it require data?

❌ No — This phrase does not require data.

</details>

<details>

<summary><code>the password is x</code></summary>

#### What does it do?

Specifies the password for the PDF.

#### Where does it go?

Indented under `unlock the file`.

#### Is it required?

✅ Yes — This phrase is **required**.

#### Does it require data?

✅ Yes — Replace **x** with a **text** value containing the PDF's password.

#### Example

```
the password is "abcd1234"
```

</details>

<details>

<summary><code>the file is the above</code></summary>

#### What does it do?

References the unlocked PDF file so it can be used for further processing.

#### Where does it go?

This phrase should be written on a **new line**.

#### Is it required?

❌ No — This phrase is **optional**.

#### Does it require data?

❌ No — This phrase does not require data.

</details>

### Examples

#### 1. Example 1

```
unlock the file
    the password is "abcd1234"
the file is the above
```

#### 2. Example 2

```
unlock the file
    the password is "secret-password"
the file is the above
```