> For the complete documentation index, see [llms.txt](https://doc.orbeon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.orbeon.com/form-builder/advanced/pdf-test.md).

# Testing PDF production

## Availability

\[SINCE Orbeon Forms 2021.1]

## How to test PDF production

There are two ways to access the "Test PDF" function:

1. directly from the Form Builder's main window's "Test" menu
2. from the "Test Form" window

![The "Test" menu](/files/SagUaMYWBY5WIgyBEANW)

When accessed directly, "Test PDF" shows the following dialog:

![The "Test PDF Production" dialog](/files/Qqy2M3DDJhrEPndRbnnt)

When accessed from the "Test Form" window, "Test PDF" shows the following dialog:

![The "Test PDF Production" dialog](/files/sir38T3kECR5j9J02OsB)

You have access to the following options:

* **Use entered form data**
  * This option only shows when accessed from the "Test Form" window.
  * When selected, any data currently entered in the form will be used to produce the PDF.
* **Disable the evaluation of "Initial Values" formulas**
  * If "Use entered form data" is selected, this option is disabled as the form data takes precedence.
  * When selected, all "Initial Value" formulas are disabled, as if they were not present.
* **Disable the evaluation of "Initial Values" formulas**
  * When selected, all "Initial Value" formulas are disabled, as if they were not present.
* **Disable the evaluation of "Calculated Values" formulas**
  * When selected, all "Calculated Value" formulas are disabled, as if they were not present.
* **Show controls, grids, and sections with dynamic visibility**
  * When selected, all controls, grids, and sections that can be dynamically shown are shown.
  * This means that those with visibility "Yes" or "Formula" are always shown. Controls with visibility "No" remain not visible.
  * Use cases include:
    * Verifying that every control, grid, or section that can appear in the PDF appears correctly.
    * Exporting the PDF file for printing and manual filling.
* **Use PDF template**
  * This only shows if the form has attached PDF templates.
  * See below for details.

Selecting "Continue" opens the resulting PDF, which will show in your browser window.

## PDF templates

The "Test PDF" dialog lets you choose between the [automatic PDF](https://github.com/orbeon/orbeon-forms-doc/blob/master/form-builder/pdf-automatic.md) or one of the available [PDF templates](https://github.com/orbeon/orbeon-forms-doc/blob/master/form-builder/pdf-templates.md) when testing.

![Selecting a PDF template for PDF testing](/files/VxLwDbia98F5Ql4akMgj)

## Showing hints and alerts

[\[SINCE Orbeon Forms 2023.1\]](/release-notes/orbeon-forms-2023.1.md)

Two options allow you to show controls hints and alerts in the resulting PDF:

![Options to show hints, alerts, and required](/files/lfwRX6povNWf9uG7O62q)

This is an example of the resulting PDF with hints and alerts:

![PDF output with alerts and hints](/files/chsgljvzNXNjzCszv0kB)

See also [The `open-rendered-format()` action](/form-runner/advanced/buttons-and-processes/actions-form-runner.md#open-rendered-format).

## See also

* Blog post: [Testing PDF production in Form Builder](https://blog.orbeon.com/2021/11/testing-pdf-production-in-form-builder.html)
* [PDF Production](https://github.com/orbeon/orbeon-forms-doc/blob/master/form-builder/pdf-production.md)
* [Automatic PDF](https://github.com/orbeon/orbeon-forms-doc/blob/master/form-builder/pdf-automatic.md)
* [PDF templates](https://github.com/orbeon/orbeon-forms-doc/blob/master/form-builder/pdf-templates.md)
* [The `open-rendered-format()` action](/form-runner/advanced/buttons-and-processes/actions-form-runner.md#open-rendered-format)
* [Testing in web mode](/form-builder/advanced/web-test.md)
* [Testing in offline mode](/form-builder/advanced/offline-test.md)