How to Show Nonprinting Instructions in Acrobat Fillable PDF Text Fields
Question details
The user needs to display instructional text inside a fillable PDF text field that remains hidden when the form is printed, but the field stays blank when using a custom validation script.

- Product
- Adobe Acrobat
- Device & OS
- not provided
- Scenario
- Creating an interactive, fillable PDF form with built-in user instructions.
- Observed behavior
- The instructional text does not appear because the JavaScript was placed in the custom validation script box, which does not trigger on field load or display.
Ensure you have access to Adobe Acrobat Pro or an advanced PDF editor that supports JavaScript form formatting and event triggers.
Move JavaScript to a Format or Focus Event and Set Print Display State
Fix the blank field issue by moving the JavaScript from the validation box to a formatting or focus event, and dynamically change the print visibility.
Validation scripts in Acrobat only run after the field's value has been modified by the user. To display instructional text before the user types anything, the script must be placed in an event that runs when the field is opened, focused, or formatted.
You must also programmatically control the field's display property so that it is visible on screen but does not print while acting as an instruction.
Open your PDF document in Adobe Acrobat, navigate to the 'Tools' menu, and select 'Prepare Form' to enable form editing.
Right-click the text field where you want the instructions to appear and select 'Properties' from the context menu.
Navigate to the 'Validate' tab and remove your existing script. Instead, go to the 'Format' tab to use a Custom Format Script, or the 'Actions' tab to trigger scripts 'On Focus' (when the user clicks the field) and 'On Blur' (when the user clicks away).
Within your script, use `event.target.display = display.noPrint;` when the instructional text is showing. When the user enters a real value, change the state back by triggering `event.target.display = display.visible;`.

Edit and Fill PDF Forms Seamlessly with WPS Office
Avoid complex JavaScript coding by using WPS Office to create, edit, and fill PDF forms. WPS PDF offers intuitive tools to add text, hints, and interactive fields with an easy-to-use interface.
- 1. Open PDF in WPS Office: Launch WPS Office and open your PDF document using the built-in WPS PDF editor.
- 2. Access Form Tools: Navigate to the 'Form' tab on the top ribbon to view all interactive form creation and editing tools.
- 3. Configure Field Properties: Insert a text field, right-click to open its properties, and easily set up tooltips or default text as user instructions.
- 4. Save and Distribute: Save your customized PDF form. The built-in hints will assist users in filling out the form without affecting the printed document.

Frequently Asked Questions
Why is my JavaScript in the PDF validation box not showing text?
Validation scripts only execute when a user alters a field's value. If you want instructional text to appear by default before any interaction occurs, you must place the script in a formatting event or use a document-level script that triggers when the PDF opens.
How do I make a PDF form field visible on screen but hidden when printing?
In the field's properties, under the General tab, look for the 'Form Field' visibility dropdown. Change the setting from 'Visible' to 'Visible but doesn't print'. You can also achieve this via JavaScript by setting `event.target.display = display.noPrint;`.
Can I show instructions in a PDF form without using JavaScript?
Yes, the simplest non-coding method is to use tooltips. Open the text field properties, go to the General tab, and type your instructions into the 'Tooltip' box. When a user hovers their mouse over the field, the instructional text will automatically appear.




