--- title: "Saving Executed Forms" slug: "saving-executed-forms" tags: ["Debug", "Form Controls, ", "Forms ", "workflow"] updated: 2025-08-15T20:28:23Z published: 2025-08-15T20:28:23Z --- > ## 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. # Saving Executed Forms ## Overview Users can save executed Forms by combining Flow Logic with a created Form. Currently, Users can save data from executed Forms as a PDF or save an entire completed Form with data and formatting as an image. Once a Form is completed, various Flow steps can be added, depending on the desired use case. For example, Users who wish to save specific data from a completed Form can use the **Merge Text Editor**to choose which Fields will be displayed for End Users. There are two Form controls available to help Users view and save completed Forms as a PDF. The **Document Viewer** Form Control enables Users to view and save the completed Form as a PDF within Decisions. Users must configure the control with the same data value as the completed Form for it to display correctly. The **File Download** Form Control enables End Users to download the completed Form via the File System. File Download is available as a link or button. Users can save the contents of a completed Form as an image by enabling the **Include Completed Form Image** checkbox on the Form. This feature is available for Users with v9.5 and above. This article walks through saving a completed Form as an image and saving data from a completed Form. Both sections include examples with a step-by-step walkthrough of building a Form as well as the Flow Logic required to accomplish each desired outcome. --- ## Saving a Completed Form as an Image The following example will discuss how to save a completed Form as an Image, using a newly created Form. This Form will include four text fields where End Users will enter their contact information. Using Collapsible Header Containers on FormsUsers who add text fields in collapsible **Header Containers** should note that these controls must be visible after End Users submit Data within them. If they are not visible, the Form will not display the Data on the Image. An **Active Form Flow** can be created to toggle visibility for these controls. For more information about Active Form Flows, please visit: [Active Form Flow Visibility](https://documentation.decisions.com/docs/active-form-flow-visibility). 1. Drag a **Show Form Step** to the workspace and attach it to the **Start**Step.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1755020917379.png) - Click **Create New** and name the Form **Contact Information**. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-12_13h41_25(1).png) 2. From here, add four text boxes to the Form and label them as: **First Name**, **Middle Initial**,**Last Name**, and **Email Address**. Add a Button and name it **Submit** before saving and closing the Form. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1755020766789.png) 3. Navigate back to the Flow and set all the Inputs on the Form to **Ignore**. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-12_13h51_14.png) 4. Scroll down to **Outcomes** and click the checkbox next to **Include Completed Form Image in Outcome**. - This action will populate a new checkbox with the name of the outcome button (Submit). Click the checkbox. This will enable Users to save the Form after clicking **Submit**. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-12_13h55_49.png) 5. Drag another **Show Form** Step to the workspace and connect it to the **Submit** Outcome. 6. Create a new Form and add a **Document Viewer** Control to it. Change the **InputType** to File Reference to match the **Completed Form Output** in the previous Step. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-12_14h01_47.png) 7. Save and close the Form. Map the Completed Form (File Reference) to the Input. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-12_14h06_24.png) 8. Click **Debug**. The Flow will generate an image of the completed Form.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/VideoProject105-ezgif.com-video-to-gif-converter.gif) 9. Users can enable downloading by adding a **File Download** Form Control to the bottom of the Form. This can be utilized as a button or link, and Users can customize how the file is downloaded in the Properties Panel. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-13_09h57_09.png) 10. Ensure the **File OutputType** is mapped to the same value as the completed Form (**FileReference**) before saving and closing the Form. 11. Click **Debug** again. The Form can now be downloaded and saved to the File System.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/Test-ezgif.com-video-to-gif-converter.gif) 12. Users can download the image and view it in their File system.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1755287224683.png) --- ## Saving Data from a Completed Form The following example demonstrates how to save data from a completed Form. This example requires a similar format to the previous example, but does not require the same properties. 1. Users will first need to create a Flow and connect a **Show Form** Step to the **Start** Step on the workspace.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-11_12h54_27.png) - From here, select **Pick or Create Form**. Choose a name for the Form and click**Create**.  ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-11_12h55_16.png) 2. In the new Form, add desired controls to the workspace. Four textboxes are added to capture an End User's **First Name**, **Middle Initial**, **Last Name**, and **Email Address**. **A Header Container** can also be added to display the type of Form. In this example, the Form is named **Contact Information**. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-11_12h21_05.png) 3. Once all the desired fields are added to the Form. Add a button and name it **Submit**. Users will click this button to submit the Form. 4. Once the Form is completed, save the Form and navigate back to Flow. 5. From here, set all the inputs on the Form to **Ignore**, then connect the outcome to a **Create Data**Step. 6. On the Create Data Step, click on **Show Editor** under **Data to Create,**and enter **HTMLstring**with **String**as the**Type.**Save and exit the window.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1754930062987.png) 7. Next, select **Merge HTML** and select the pencil icon. This action will populate the **Merge Text Editor**. 8. From here, enter a desired title. For this example, the same title as the **Header Container** on the previous Form is used. 9. Enter the name of each field on the previous Form and drag the associated data value from the Menu on the left-hand side of the window. The result should look similar to the image below. 10. After the desired information has been entered, click **Save**. This information is what will be displayed in a PDF for Users after clicking **Submit** on the Form. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-11_12h30_46.png) 11. Drag an **HTML to PDF** step and connect the **Done** outcome to the Create Data Step. Connect the **failed** outcome to the End Step. This Step will convert the HTML string created in the previous Step to a PDF. If the Step fails for any reason, the Flow will end. Users can make note of areas that have issues in the **Debugger**. 12. Select **Flow Data** and map in the **HTML String Output** from the Create Data Step. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-11_12h36_00(1).png) 13. The Inputs, **Include****Page Numbers** and **Page Number Alignment,** are ignored, but both inputs can be customized to the User's desired specifications. The PDF file name for this example is **Testform.pdf**. 14. After all the Inputs have been mapped. Connect the outcome to another**Show Form** Step. 15. Create a new Form and add a **Document Viewer**control to the workspace. This control will display the completed Form in the previous Form as a PDF. 16. Before saving the Form, ensure the**InputType** is set to File Data and the desired data name is entered. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-11_12h56_19.png) 17. Once the Form is completed, click **Save** and navigate back to the Flow. Map the **PDF File** outcome (File Data) from the **HTML to PDF**Step.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-11_12h59_08.png) 18. Connect the outcome to the End Step and click **Debug**. Users who submit the Form will now be able to view and download the executed Form as a PDF.  ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/SavingExecutedForms-ezgif.com-video-to-gif-converter.gif) --- ## Feature Changes | Description | Version | Release Date | Developer Task | | --- | --- | --- | --- | | Users can now save the contents of a filled-out Form as a PDF or image file on submission. | [9.5](https://documentation.decisions.com/v99/docs/version-95x-release-notes?highlight=DT-036762) | November 2024 | DT-046762 | ## Related - [Form Control Glossary](/form-control-glossary.md) - [Forms](/forms.md) - [Form Settings in the Flow Designer](/form-settings-in-the-flow-designer.md) - [Form Organization](/form-organization.md)