PDF Editing Issues

How to Show Nonprinting Instructions in Acrobat Fillable PDF Text Fields

Bushra ParveenBushra Parveen Nov 2, 2026 869 views

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.

How to Show Nonprinting Instructions in an Acrobat Fillable PDF
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.
Before you start

Ensure you have access to Adobe Acrobat Pro or an advanced PDF editor that supports JavaScript form formatting and event triggers.

Solution 1Recommended

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.

1
Enter Prepare Form Mode

Open your PDF document in Adobe Acrobat, navigate to the 'Tools' menu, and select 'Prepare Form' to enable form editing.

2
Open Text Field Properties

Right-click the text field where you want the instructions to appear and select 'Properties' from the context menu.

3
Reposition the JavaScript

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).

4
Update the Display State via Script

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;`.

Move JavaScript to a Format or Focus Event and Set Print Display State
Alternative to JavaScript: If you do not want to use complex JavaScript to handle non-printing instructions, you can simply add a 'Tooltip' in the field's General properties, which displays helpful text when the user hovers over the field.
Easy PDF Form Editing

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. 1. Open PDF in WPS Office: Launch WPS Office and open your PDF document using the built-in WPS PDF editor.
  2. 2. Access Form Tools: Navigate to the 'Form' tab on the top ribbon to view all interactive form creation and editing tools.
  3. 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. 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.
Easily add and edit text fields and tooltips in PDF forms without writing code.Fully compatible with Microsoft Word, Excel, PowerPoint, and Adobe PDF formats.Lightweight, fast, and user-friendly interface for seamless document management.Available across Windows, Mac, mobile, and web platforms.
microsoft office alternative - wps office

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.