PDF Editing Issues

How to Add Placeholder or Ghost Text in Acrobat Form Fields

Amos GikundaAmos Gikunda Oct 28, 2026 869 views

Question details

The user wants to display instructional placeholder (ghost) text inside an empty PDF form field in Adobe Acrobat to guide respondents.

How to Add Placeholder or Ghost Text to Acrobat Form Fields
Product
Adobe Acrobat
Device & OS
not provided
Scenario
Creating interactive PDF forms where text fields need to display default instructional text when no value is entered by the user.
Observed behavior
Acrobat text fields do not feature a native placeholder property or support standard mouse-over/mouse-out behaviors, requiring a custom JavaScript workaround.
Before you start

Before adding custom scripts, ensure your PDF form fields are properly named and formatted. Remember that adding placeholder text via JavaScript inserts actual text into the field, which may affect form validation or calculations.

Solution 1Recommended

Use a Custom Format Script to Add Placeholder Text

Apply a simple JavaScript snippet to the field's formatting properties to display default instructions when the field is empty.

Acrobat JavaScript can conditionally display text when a field is empty. Because the script assigns the instructional text as the actual field value, you should test the field thoroughly to ensure it does not break backend data submission or dependent calculations.

1
Enter Form Editing Mode

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

2
Access Field Properties

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

3
Navigate to the Format Tab

In the Text Field Properties dialog box, click on the 'Format' tab at the top.

4
Select Custom Format Category

Click the 'Select format category' dropdown menu and choose 'Custom' from the list of options.

5
Add the Custom Script

In the 'Custom Format Script' box, enter the following code: if (!event.value) event.value = "Message text goes here."; Replace the sample message with your specific instructions, click OK, and close the properties window.

Use a Custom Format Script to Add Placeholder Text
Limitation of Mouse-Over Events: Acrobat text fields do not support standard mouse-over or mouse-out behaviors for placeholder text. Users will typically need to highlight and type over the placeholder text unless additional focus scripts are applied.
Complete PDF Form Solution

Create and Fill PDF Forms Easily with WPS Office

WPS Office offers a robust PDF editor that allows you to easily create, edit, and fill out interactive PDF forms without relying heavily on complex scripting. It is an excellent, lightweight alternative for handling document workflows.

  1. 1. Open WPS Office PDF Editor: Launch WPS Office, navigate to the 'PDF' tab, and open your existing PDF document or create a new one.
  2. 2. Access Form Tools: Click on the 'Form' tab in the top ribbon to view all available form creation and editing tools.
  3. 3. Add and Edit Fields: Select the desired form field type (like Text Field) and drag it onto your document page.
  4. 4. Customize Properties: Double-click the newly created field to easily adjust its name, appearance, and default text properties.
Easily insert text fields, checkboxes, and interactive buttonsHigh compatibility with Adobe Acrobat PDF formatsLightweight interface that consumes fewer system resourcesSeamless document editing across Windows, Mac, and mobile devices
microsoft office alternative - wps office

Frequently Asked Questions

Does the placeholder text disappear automatically when a user clicks the field?

Not automatically with just the format script. The user will typically need to highlight and overwrite the text unless you implement additional Keystroke or On Focus JavaScript to clear the field upon selection.

Will the placeholder text print when I print the form?

Yes. Because the custom format script assigns the placeholder text as the actual field value when empty, it will appear on the printed document if left unchanged by the user.

Can I add tooltips instead of placeholder text?

Yes. In the field Properties under the General tab, you can add instructional text to the 'Tooltip' box. This text appears when the user hovers their mouse over the field, which is often a cleaner alternative to JavaScript placeholders that avoids data submission issues.

Why is my form calculation failing after adding ghost text?

Since the placeholder script inputs actual text strings into the field, any calculation expecting a strict numerical value will encounter an error or fail to execute properly. You should avoid applying placeholder scripts to fields involved in mathematical calculations.