---
title: "PDF Template Administration"
slug: "pdf-template-administration"
updated: 2025-09-25T23:51:58Z
published: 2025-09-25T23:51:58Z
canonical: "docs.unqork.io/pdf-template-administration"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unqork.io/llms.txt
> Use this file to discover all available pages before exploring further.

# PDF Template Administration

The PDF Template Administration page displays a list of all PDFs uploaded to your environment. You can also replace, remove, and download PDFs from the PDF Template Administration page. Upload PDFs to reference them in modules and create mappable templates for use in Express View.

## Creating a PDF Template

Start by creating a PDF Template in Adobe Acrobat.

> [!NOTE]
> The Name of each field in your PDF Template must correspond to the Property ID of a component in your module. Where Names and Property IDs mismatch, mapping won't work.

To create a PDF Template:

1. Use the **Prepare Form** feature in Adobe Acrobat to design the look of your PDF.
2. Match each PDF Template field's Name to the Property ID of its corresponding Unqork component.

![A static image displaying the Adobe Acrobat Check Box Properties screen, the Name field contains the Property ID used to map to the PDF Template plug-in.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/PDFTemplateAdmin01.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A47Z&se=2026-11-07T18%3A57%3A47Z&sr=c&sp=r&sig=OVs8uFD9qGDTSSCcpEHYa8zxSjRV7S9a9azEgrU1nH0%3D)
3. **Save** your PDF template.

## Uploading a PDF Template

PDF Template Administration is where you store your mapped PDF template files. Once uploaded, you can reference PDF templates from your modules. Later, you'll learn how to use a DataMapper component to transform information in your module into a PDF.

To upload your PDF template to PDF Template Administration:

1. At the top right of the Unqork Designer Platform, click the **Settings** drop-down.
2. Click **Administration**.
3. Under **Integration**, select **PDF Template Administration**.
4. Click the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/PDFTemplateAdmin03(1).jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A47Z&se=2026-11-07T18%3A57%3A47Z&sr=c&sp=r&sig=OVs8uFD9qGDTSSCcpEHYa8zxSjRV7S9a9azEgrU1nH0%3D) (**Upload**) button, located at the top right of the PDF Template list.

> [!TIP]
> You can add files of any size, there is no restriction.

![A static image of the PDF Template Administration page with the Upload Button highlighted.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/PDFTemplateAdmin02.jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A47Z&se=2026-11-07T18%3A57%3A47Z&sr=c&sp=r&sig=OVs8uFD9qGDTSSCcpEHYa8zxSjRV7S9a9azEgrU1nH0%3D)
5. Navigate to and select your file for upload.
6. Click **Open**. Your uploaded file displays in the PDF Template list.

## Replacing a PDF Template

You can upload a new version of your PDF template if it changes. The uploaded file replaces the original file in the PDF Template Administration list. After upload, the Last Modified column of the PDF Template Administration list shows the updated date/time.

To replace your PDF template:

1. At the top right of the Unqork Designer Platform, click the **Settings** drop-down.
2. Click **Administration**.
3. Under **Integration**, select **PDF Template Administration**.
4. In the PDF Template list, navigate to the file you want to replace.
5. Select the file.
6. Click the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/PDFTemplateAdmin03(1).jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A47Z&se=2026-11-07T18%3A57%3A47Z&sr=c&sp=r&sig=OVs8uFD9qGDTSSCcpEHYa8zxSjRV7S9a9azEgrU1nH0%3D) (**Upload**) button.
7. Navigate to and select your file for upload.
8. Click **Open**.
9. At the **File Exists** message, click **Confirm**.

> [!NOTE]
> Clicking **Cancel** stops the process and returns you to the PDF Template list.

## Removing a PDF Template

You can remove files from the PDF Template list. If you remove a mapped PDF template, the mapping no longer works. Remove or replace the mapping in the DataMapper component before removing the file.

1. At the top right of the Unqork Designer Platform, click the **Settings** drop-down.
2. Click **Administration**.
3. Under **Integration**, select **PDF Template Administration**.
4. In the PDF Template list, navigate to the file to remove.
5. Select the file.
6. Click the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/PDFTemplateAdmin05(1).jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A47Z&se=2026-11-07T18%3A57%3A47Z&sr=c&sp=r&sig=OVs8uFD9qGDTSSCcpEHYa8zxSjRV7S9a9azEgrU1nH0%3D) (**Remove**) button, located at the top right of the list.
7. At the Remove message, click **Confirm**. The file no longer appears in the PDF Template Administration list.

> [!NOTE]
> Clicking Cancel stops the removal process and returns you to the PDF Template list.

## Downloading a PDF Template

When promoting a module, secondary files aren't promoted. When you promote modules, add PDF templates to each environment. To do this, download the PDF template from the original environment, then upload it to the new environment.

To download your PDF file:

1. At the top right of the Unqork Designer Platform, click the **Settings** drop-down.
2. Click **Administration**.
3. Under **Integration**, select **PDF Template Administration**.
4. In the PDF Template list, navigate to the file to download.
5. Select the file.
6. Click the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/PDFTemplateAdmin04(1).jpg?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A47Z&se=2026-11-07T18%3A57%3A47Z&sr=c&sp=r&sig=OVs8uFD9qGDTSSCcpEHYa8zxSjRV7S9a9azEgrU1nH0%3D) (**Download**) button, located at the top right of the list.
7. Locate your file in your **Downloads** folder.

## Referencing a PDF Template in a Module

Now that you've created and uploaded a PDF Template to your environment, build the module form that enables the end-user to fill the PDF template.

> [!NOTE]
> This configuration assumes you already have a module saved with a title, and a PDF template saved and uploaded to PDF Template Administration.

### Configure the Panel Component

Start by adding a Panel component to your module. The Panel component will house all your other components to keep them organized.

1. In the Module Builder, drag and drop a **Panel** component onto your canvas.
2. Click **Save**.

### Configure the Text Field Components

Add the three Text Field components. These fields will collect some simple information about the end-user. For this example, assume the Property IDs of each Text Field corresponds to the Name of a field in a PDF template.

> [!NOTE]
> When configuring your own use case, match your module's fields to the field Names in your PDF template.

1. In the Module Builder, drag and drop three **Text Field** components into your **Panel** component.
2. Complete the **Property ID** and **Label Text** fields for each component as follows:

| Property ID | Label Text |
| --- | --- |
| firstName | First Name |
| lastName | Last Name |
| occupation | Occupation |
3. **Save** each component as you add it.

### Configure the Plug-In Component

The Plug-In component retrieves the information from your Text Field components and matches it to your PDF Template.

1. Drag and drop a **Plug-In** component onto your canvas.
2. In the **Property ID** and **Canvas Label Text** fields, enter **plugGeneratePdf**.
3. From the **Internal Services** drop-down, select **Generate PDF from Template (PDF Bar)**. This populates the Data Source URL and changes the request type to **POST**.

![A static image of the Plug-In Configuration page showing the Data Settings panel. Settings that have been changed are highlighted in gold.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/PDF_Template_plugin_servicetype.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A47Z&se=2026-11-07T18%3A57%3A47Z&sr=c&sp=r&sig=OVs8uFD9qGDTSSCcpEHYa8zxSjRV7S9a9azEgrU1nH0%3D)
4. In the **Inputs** table, enter the following:

| Property ID | Mapping |
| --- | --- |
| firstName | firstName |
| lastName | lastName |
| occupation | occupation |
| 'pdf_template_example' | templateName |

> [!NOTE]
> This example uses the pdf_template_example.pdf template from the Training environment. If you're using your own template, replace the pdf_template_example in the Property ID field with the name of the PDF template uploaded to **PDF Template Administration**.
5. In the **Outputs** table, enter the following:

| Property ID | Mapping | Option |
| --- | --- | --- |
| pdfUrl | urlPDF | Replace |

> [!NOTE]
> urlPDF is the Cloud Storage URL for the generated PDF. Here, you're mapping the URL to pdfUrl, which is the Property ID of the Hidden component you'll set up next. The Hidden component stores the URL of the generated PDF.

![A static image of the Plug-In Configuration page showing the Data Settings panel. Settings that have been changed are highlighted in gold.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/PDF_Template_plugin_data.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A47Z&se=2026-11-07T18%3A57%3A47Z&sr=c&sp=r&sig=OVs8uFD9qGDTSSCcpEHYa8zxSjRV7S9a9azEgrU1nH0%3D)
6. Under the **Actions** Panel, in the **Post Trigger** field, enter **rulePdf**.

![A static image of the Plug-In Configuration Actions Panel. The Post Trigger setting is highlighted in gold.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/PDF_Template_plugin_actions.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A47Z&se=2026-11-07T18%3A57%3A47Z&sr=c&sp=r&sig=OVs8uFD9qGDTSSCcpEHYa8zxSjRV7S9a9azEgrU1nH0%3D)
7. Click **Save**.

### Configure the Hidden Component

Here you'll add the Hidden component that stores the URL for the generated PDF.

1. Drag and drop a **Hidden** component onto the canvas.
2. In the **Property ID** and **Canvas Label Text** fields, enter **pdfUrl**.
3. Set **Store Data in Database** to ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/toggle_ON(10).png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A47Z&se=2026-11-07T18%3A57%3A47Z&sr=c&sp=r&sig=OVs8uFD9qGDTSSCcpEHYa8zxSjRV7S9a9azEgrU1nH0%3D) **(ON)**.
4. Click **Save**.

### Configure the Decisions Component

Next, set up the Decisions component. When a new URL populates in the pdfUrl Hidden component, the Decisions component opens that URL in a new tab.

1. Drag and drop a **Decisions** component onto your canvas.
2. In the **Property ID** and **Canvas Label Text** fields, enter **rulePdf**.
3. In the **Inputs** table, enter the following:

| Property ID | Type | Required |
| --- | --- | --- |
| pdfUrl | exact | Yes (selected) |
4. In the **Outputs** table, enter the following:

| Property ID | Type |
| --- | --- |
| pdfUrl | pageOpen |

> [!TIP]
> An Output Type of pageOpen opens the URL in a new tab. To open the URL in the same tab, select an Output Type of page.
5. In the **Micro Decisions** table, enter the following:

| pdfUrl | pdfUrl_pageOpen |
| --- | --- |
|  | =pdfUrl |

![A static image of the Decisions component configuration panel. The Action panel is displayed and the Inputs, Outputs, and MicroDecisions sections are highlighted.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/PDF_Template_decisions_actions.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A47Z&se=2026-11-07T18%3A57%3A47Z&sr=c&sp=r&sig=OVs8uFD9qGDTSSCcpEHYa8zxSjRV7S9a9azEgrU1nH0%3D)
6. Click **Save**.

### Configure the Button Component

Finally, add a Button component to kick off the PDF creation process. This Button triggers the **plugGeneratePdf** Plug-In component on button-click.

1. Drag and drop a **Button** component onto your canvas.
2. In the **Property ID** field, enter **btnGenerate**.
3. In the **Label Text** field, enter **Generate PDF**.
4. From the **Action Type**, select **Event**.
5. In the **Trigger on Click** field, enter **plugGeneratePdf**.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/PDF_Template_button_actions.png?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A47Z&se=2026-11-07T18%3A57%3A47Z&sr=c&sp=r&sig=OVs8uFD9qGDTSSCcpEHYa8zxSjRV7S9a9azEgrU1nH0%3D)
6. Click **Save**.
7. **Save** your module.

This is the result in Express View:

![An animated image of Express View showing the PDF Template feature in action.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/PDF_Template_ExampleGif.gif?sv=2026-02-06&spr=https&st=2026-11-07T17%3A57%3A47Z&se=2026-11-07T18%3A57%3A47Z&sr=c&sp=r&sig=OVs8uFD9qGDTSSCcpEHYa8zxSjRV7S9a9azEgrU1nH0%3D)