> For the complete documentation index, see [llms.txt](https://support.docstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.docstudio.com/user/template-builder/template-editor/how-to-add-pdf-documents-in-a-template.md).

# How to Add PDF Documents in a Template

{% columns %}
{% column %}
A PDF document is a file added to your template.

It can be:

* Uploaded directly to the template.
* Left empty for an envelope participant to upload later (depending on their assigned role).

Use a **PDF document** when the file must stay in PDF format.

Use an **External document** when users must upload non-PDF files or when you need broader file type support.
{% endcolumn %}

{% column %}

<figure><img src="/files/1CzY7wH2N3JRvB2LYLQ0" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Limits

{% hint style="info" %}
By default, an envelope can contain up to **50** PDF and external documents in total. Your system admin can change this limit.
{% endhint %}

### Add a PDF document to a template

{% columns %}
{% column width="50%" %}

1. Open the **Documents** panel.
2. Click the <img src="/files/ekbMrgh2yIWE1HFR3sA3" alt="" data-size="line"> button.
3. Click **PDF document**.
4. In the file picker, select a PDF to upload.
5. Or close the file picker to keep the document empty.

If you upload a PDF, DocStudio adds it to the template immediately. If you close the file picker, the PDF document stays empty for later upload.
{% endcolumn %}

{% column width="50%" %}

<figure><img src="/files/DsAeCmDYAuuPhdxTQAlQ" alt="" width="170"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
If the PDF document is empty, it can be uploaded later by envelope participants. By default, the document is assigned to **Sender**.
{% endhint %}

### Configure PDF document properties

You can edit properties only when no PDF is uploaded yet.

Available properties are more limited than for an external document.

You can configure:

* role
* optionality

You can also add signature fields to the PDF document after you add it to the template.

### Import PDF fields

Import embedded PDF fields from the uploaded PDF to convert supported fields to DocStudio fields.

Conversion map:

* text → text field
* date → text field
* checkbox → checkbox field
* radio button → choice field
* dropdown menu → dropdown field
* listbox → dropdown field
* signature → PAdES field (only if enabled by a system administrator)
* picture → not supported (ignored)
* barcode → not supported (ignored)

All imported fields, except for dropdown-based fields, inherit the optional or mandatory attributes from the original PDF.

### Upload options for encrypted or filled PDFs

Depending on PDF content and encryption, you may see different upload options. Only applicable options are shown for each file.

1. Preserve encryption. Existing fields are converted, but you can add only new electronic signature fields.
2. Save existing data and signatures. You can add only new electronic signature fields.
3. Convert all fields without preserving encryption. All fields can be converted, new fields can be added, and DocStudio may create a new role for each signature.
4. Save the document “as is”. Existing fields stay disabled and are not converted, but you can add new fields.
5. Remove all existing fields and signatures. Existing fields are removed and you can add any new fields.

### Duplicate a PDF document

1. In the document header, click the **Context menu** ![](/files/uAUQhDjmbXg2EPu5fnnt) icon.
2. Click the <img src="/files/oEScpjogkx0tap18ujRR" alt="" data-size="line"> icon.

DocStudio creates a copy of the PDF document slot with the same settings.

### Delete a PDF document

1. In the document header, click the **Context menu** ![](/files/uAUQhDjmbXg2EPu5fnnt) icon.
2. Click the <img src="/files/xHPbi9SCPV2ZnMd1FwfU" alt="" data-size="line"> icon.

{% hint style="warning" %}
Deleting the PDF document removes it and its configuration from the template.
{% endhint %}

{% columns %}
{% column %}

<figure><img src="/files/XbjiZQARwCriRjUHtbjW" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/RrOWBjj1BXoZUnsSxaC2" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Related topics

* [How to Add External Documents to a Template](/user/template-builder/template-editor/how-to-add-external-documents-to-a-template.md)
* [How to Create a Structured Template](/user/template-builder/template-editor/how-to-create-a-structured-template.md)
* [External Documents in the Envelope](/user/external-documents-in-the-envelope.md).