Form Fields in PDFs — Complete Guide

In this tutorial, you will learn about Form Fields in PDFs. We cover key concepts, practical examples, and best practices to help you master this topic.

Accessible form fields in PDFs require each interactive element — text input, checkbox, radio button, combo box, and button — to have a visible label, a tooltip, correct tab order, and proper tagging so screen readers can announce the field name, type, value, and any error messages.

What You'll Learn

You will learn how to add form fields in Acrobat Pro, how to set tooltips and Accessibility properties, how to configure tab order, how to handle validation and error messages, and how to verify forms with screen readers.

Why It Matters

Forms are the most interactive element in PDFs. If form fields are untagged or lack tooltips, screen reader users cannot determine what to enter, receive no feedback on errors, and may be unable to submit the form at all.

Real-World Use

A healthcare provider offers patient intake forms as PDFs. Before accessibility remediation, the date-of-birth field had no label — the screen reader announced "Edit" — and the error message for invalid dates appeared as a popup that was invisible to screen readers. After adding tooltips, visible labels, and accessible error announcements, patients who use screen readers can complete the form independently.

Form Field Tagging

flowchart TD
  A["
 Tag"] --> B["Text Field: Name"]
  A --> C["Radio Button Group: Gender"]
  A --> D["Checkbox: Agree to Terms"]
  A --> E["Combo Box: State"]
  A --> F["Button: Submit"]
  B --> B1["Tooltip: 'Enter your full name'"]
  C --> C1["Tooltip: 'Select your gender'"]
  D --> D1["Tooltip: 'I agree to the terms and conditions'"]
  E --> E1["Tooltip: 'Choose your state'"]
  F --> F1["Tooltip: 'Submit the form'"]

Creating Accessible Form Fields

Adding Tooltips in Acrobat Pro

1. Open the Prepare Form tool (Tools > Prepare Form).
2. Right-click a form field and select Properties.
3. In the General tab, enter a description in the Tooltip field.
4. Click Close.

// Acrobat JavaScript to add tooltips to all form fields
var fields = this.getFields();
for (var i = 0; i < fields.length; i++) {
    var f = fields[i];
    if (!f.userName || f.userName === "") {
        f.userName = "Please enter " + f.name.replace(/_/g, " ");
    }
    console.println("Set tooltip for field: " + f.name);
}

Setting Tab Order

1. Open the Pages panel.
2. Right-click a page thumbnail and select Page Properties.
3. In the Tab Order tab, choose "Use Row Order" or "Use Structure Order".
4. Reorder fields using the Fields panel (drag to reorder).

Error Handling

PDF forms cannot natively announce errors interactively. Acrobat JavaScript validation scripts can show error popups, but these are not accessible. Instead:

• Place error messages in visible text fields adjacent to the input
• Use a live region approach: set a hidden text field's value to the error message and give it a tooltip
• Include instructions for correction in the tooltip

// Accessible validation using a text field for error display
function validateAge(field) {
    var age = parseInt(field.value);
    if (isNaN(age) || age < 0 || age > 150) {
        this.getField("errorMessage").value = "Age must be a number between 0 and 150.";
        field.setFocus();
    } else {
        this.getField("errorMessage").value = "";
    }
}

Common Mistakes

1. Missing tooltips — Tooltips are the primary way screen readers identify form fields. A field without a tooltip announces as "Edit" or "Untitled."

2. Labels that disappear — If a label is image-based or placed outside the field area, it may not be associated with the field. Use actual text labels adjacent to fields.

3. Incorrect tab order — Tab order that jumps randomly across the page is disorienting. Set tab order to follow visual reading order (left to right, top to bottom).

4. Radio buttons not grouped — Each radio button in a group must share the same field name. Screen readers announce the group name and the number of options.

5. No instructions for required fields — Use the tooltip or a visible note to indicate which fields are required. Acrobat's "Required" flag alone does not produce an accessible cue.

Practice and Challenge

1. Which property of a form field provides the accessible name for screen readers?
2. How do you group radio buttons so screen readers announce them as a set?
3. What is the recommended tab order for a column-based form layout?
4. How can you provide accessible error messages in a PDF form?
5. Why should checkboxes have a tooltip even when they have a visible label next to them?

Challenge: Create a 1-page PDF form with at least 6 fields: first name, last name, email, state (combo box), agree to terms (checkbox), and submit (button). Add tooltips, correct tab order, radio buttons for gender, and an accessible error message for email validation. Test with NVDA and document any issues.

FAQ

Mini Project

Create a 2-page PDF job application form with: text fields for name, email, phone, and address; radio buttons for work authorization; checkboxes for skills; a combo box for years of experience; and a submit button. Set tooltips, tab order, and accessible error handling. Test with a screen reader and write a one-page remediation report.

What's Next

Continue to Language Tagging in PDFs to learn how to set document language and mark language changes, then proceed to Color Contrast in PDFs.