--- title: "Adding Background Image to a PDF" slug: "adding-a-background-image-to-a-pdf" tags: ["pdf", "background"] updated: 2025-07-09T17:48:09Z published: 2025-07-09T17:48:09Z 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 | ## Step Details | | --- | | **Introduced in Version** | --- | | **Modified in Version** | --- | | **Location** | Data > PDF | The **Add Background Image to a PDF** step allows a user to add an image to a PDF file. --- ## Property #### Settings | Property | Description | Data Type | | --- | --- | --- | | Choose values At Runtime | Allows the background image to only be applied to some PDF files that the user defines | --- | | Add To All PDF Pages | Applies the background to all PDF pages. Enabled by default | --- | | Override Existing Background | Allows the new background image to override an existing background | --- | #### Inputs | Property | Description | Data Type | | --- | --- | --- | | Image | Image to use for background | FileData | | Pdf Document | PDF file to add background image to | FileData | Outputs | Property | Description | Data Type | | --- | --- | --- | | Done | | | | | Pdf Document Result | The PDF file with the modified background | File Data | ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1666375602152.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/v9/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/2025-06-24_11h02_53.png) 4. Create and add a [Form](/v9/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/2025-06-24_11h04_46.png) 8. Add a Button to the Form and close the Form Designer.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-24_11h05_52.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/2025-06-24_11h06_41.png) 11. Debug the Flow. The background image will be applied to the PDF files when viewed through the **Document Viewer**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-24_11h07_37.png) --- Related Information Forum Posts: [Add A Image To A PDF Within A Flow](https://community.decisions.com/discussion/23644/add-a-image-to-a-pdf-within-a-flow) [Merge Multiple PDFs](https://community.decisions.com/discussion/1087/merge-multiple-pdfs) [How To Turn A Form Into A PDF?](https://community.decisions.com/discussion/25151/how-to-turn-a-form-into-a-pdf) ## Related - [Convert PDF to PCL Step](/convert-pdf-to-pcl-step.md) - [Set PDF Password](/set-password-pdf.md) - [Merge PDF Documents](/merge-pdf.md)