---
title: "Adding Background Image to a PDF"
slug: "adding-a-background-image-to-a-pdf"
updated: 2026-06-29T20:02:53Z
published: 2026-06-29T20:02:53Z
canonical: "documentation.decisions.com/adding-a-background-image-to-a-pdf"
---

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

# Adding Background Image to a PDF

## Overview

PDF Files can be customized as part of a Flow. The following example demonstrates how to use the **Add Background Image to a PDF** step to add an image to a PDF file.

---

## Settings

Under **Settings** in the **Properties** panel, the step can be configured to apply the background image to some PDF files or override an existing background image. Below is a brief overview of each setting:

|  |  |
| --- | --- |
| Choose Values At Runtime | If enabled, allows the background image to only be applied to some PDF files that the user defines |
| Add To All PDF Pages | If enabled, applies the background to all PDF pages. Enabled by default. |
| Override Existing Background | If enabled, allows the new background image to override an existing background |

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778777194046.png)

---

## Example

The following example adds an image to a PDF file using the Add Background to PDF step.

1. [Create a new Flow.](https://documentation.decisions.com/version-10/docs/creating-your-first-flow-2)
2. Expand the **Data > PDF** steps and select the **Add Background Image to PDF** step to the workspace.
3. With the step selected. In the **Properties** panel, define the Image and PDF Document inputs.  
For this example, these inputs are set to constant values.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778777551898.png)
4. Create and add a [Form](/version-10/docs/create-a-form) step.
5. In the Form Designers Toolbox tab, search for the **Document Viewer** control.
6. In the **Properties** panel for the control, under the **InputType** header, select the File Data.
7. Name the input field using **Data Name** in the **Properties** panel. **MyPDF** is used for the Data Name input.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778777666467.png)
8. Add a Button to the Form and close the Form Designer.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778777776935.png)
9. Map the **Pdf Document Result** to the **MyPDF** field on the Form.
10. Connect the Form to the End step.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778777982814.png)
11. Debug the Flow. The background image will be applied to the PDF files when viewed through the **Document Viewer**.