How to Create a Three-State Checkbox in an Adobe PDF Form
Question details
The user wants to create a checkbox in a PDF form that can cycle through three distinct states, such as pass, fail, and blank.

- Product
- Adobe Acrobat
- Device & OS
- not provided
- Scenario
- Designing an interactive PDF form that requires a tri-state selection option instead of a standard binary checkbox.
- Observed behavior
- Adobe Acrobat does not offer a native three-state checkbox, requiring users to rely on custom JavaScript and a button field workaround.
Ensure you have access to the desktop version of Adobe Acrobat Pro, as custom JavaScript form fields may not function correctly in mobile PDF viewers or basic web browsers.
Create a Custom Button with JavaScript to Simulate a Tri-State Checkbox
Use a button field styled like a checkbox and apply a MouseUp JavaScript action to cycle through the three states.
Since Acrobat does not have a native three-state checkbox, you must use a Button field. Buttons are highly customizable and can store their current state in properties like the button caption.
Acrobat JavaScript does not support double-click events, so the most reliable method is to advance to the next state (blank, pass, fail) with each single click.
Open your PDF in Adobe Acrobat Pro, go to the Tools menu, and select 'Prepare Form'.
Select the 'Add a Button' tool from the toolbar and place it on your document. Resize it to resemble a standard checkbox.
Right-click the new button, select 'Properties', and navigate to the 'Options' tab. Set the layout to 'Label only' so the caption can display your state indicators (like a checkmark or cross).
Switch to the 'Actions' tab. Select 'Mouse Up' as the trigger, choose 'Run a JavaScript' from the action dropdown, and click 'Add'.
In the JavaScript editor, enter a switch statement that reads the current button caption using event.target.buttonGetCaption() and updates it to the next state (e.g., from blank to 'Pass', 'Pass' to 'Fail', and 'Fail' back to blank).

Edit and Manage PDFs Easily with WPS Office
While advanced JavaScript form scripting is specific to Adobe Acrobat, WPS Office provides a comprehensive, lightweight, and free alternative for your everyday PDF editing, form filling, and document creation needs. Enjoy seamless compatibility with Microsoft Office formats and an intuitive user interface.
- 1. Download WPS Office: Visit the official WPS Office website and download the installer for your operating system.
- 2. Install the application: Run the setup file and follow the on-screen instructions to install the software.
- 3. Open your PDF: Launch WPS Office and open your PDF document to start reading, editing, or filling out standard forms.

Frequently Asked Questions
Can I use a regular Checkbox field for three states in Acrobat?
No, the native Checkbox field in Adobe Acrobat only supports two states (checked and unchecked). You must use a Button field and custom JavaScript to achieve a three-state toggle.
Will my three-state checkbox work on mobile PDF viewers?
Most mobile PDF viewers and web browsers do not fully support Adobe Acrobat JavaScript. This custom three-state button will likely only function correctly in desktop versions of Adobe Acrobat and Acrobat Reader.
How do I store the current state of the three-state button?
The most common method is to store the current state (e.g., blank, pass, fail) in the button's caption property. Your JavaScript can read this property on each click to determine the next state to display.
Can I trigger a state change using a double-click event?
Acrobat JavaScript does not support a native double-click event. The best approach is to use a standard 'Mouse Up' action that advances to the next state with each single click.




