Includoc, home

Tagged form fields and Field descriptions – Failed

Acrobat’s form rules fail when fillable fields aren’t tagged or have no tooltip. How to tag fields, write field descriptions and handle XFA forms.

Last updated

This message comes from Adobe Acrobat's Accessibility Checker.

Tagged form fields – Failed and Field descriptions – Failed are the two rules in the Forms category of Adobe Acrobat Pro's Accessibility Checker. The first fails when a fillable field isn't part of the document's structure (its tags). The second fails when a field has no text description, called a tooltip. If either fails, screen reader users may not find a field at all, or may hear "edit text" with no idea what to type.

What this means

The two rules check two separate jobs:

  • Tagged form fields: Adobe's help says that in an accessible PDF, every form field is tagged and part of the document structure. Each field belongs in a Form tag, placed next to its printed label in the reading order.
  • Field descriptions: Adobe's help says every form field needs a text description, its tooltip. Screen readers announce the tooltip as the field's name, so it should match the printed label and include any format hints, such as "Date of birth (MM/DD/YYYY)".

Two harder cases are worth knowing about:

  • Dynamic XFA forms, an older Adobe format made with tools such as Adobe LiveCycle Designer, aren't supported by many PDF readers or assistive technologies, and PDF/UA, the ISO standard for accessible PDFs, doesn't allow them. They need to be rebuilt as a standard PDF form (an AcroForm) before they can be made accessible.
  • Fields drawn over a scanned page, where the printed labels are only pictures until the page has been run through OCR (text recognition).

Passing both rules doesn't mean a form is usable. A person still needs to check that labels are clear, that required fields are marked in words rather than only with color or a symbol, and that instructions come before the fields they apply to.

Why it matters

Forms are how people apply for permits, benefits, jobs and programs. Untagged or unlabeled fields can make that impossible without help. Screen reader users need the label read with the field. Voice control users need it too: they say a field's name to move to it. Keyboard users need fields in a logical order. This affects WCAG 2.1 success criteria 1.3.1 Info and Relationships, 3.3.2 Labels or Instructions and 4.1.2 Name, Role, Value.

How to fix it in Acrobat Pro

  1. Field descriptions: open the Prepare Form tool. Right-click each field, choose Properties, and on the General tab type a clear Tooltip that matches the printed label and includes any format hints.
  2. Tagged form fields: open the Tags panel (Accessibility tags in newer versions). From its options menu, choose Find, look for Unmarked Annotations, and use Tag Element with the type Form for each field. Older versions of Acrobat also had an Autotag Form Fields command.
  3. Drag each Form tag next to the tag that holds its printed label, in the order people should fill in the form.
  4. Set each page's tab order to Use Document Structure (Page Properties > Tab Order), then press Tab through the form to test it.
  5. Run the check again. Both rules should pass. If you can, test the form with a screen reader as well.

Fix it in the source file

Word and most word processors can't export fillable PDF fields, so fields are usually added afterward in a PDF editor such as Acrobat. You can still make the PDF form much easier to fix:

  • Put a clear printed label next to every field, including any format the answer needs.
  • Mark required fields in words, such as "(required)".
  • Put instructions before the fields they apply to.
  • Don't use rows of underscores or dots to draw blanks. Screen readers read every character.
  • If the form is an XFA form, rebuild it as a standard PDF form rather than trying to patch it.

After the fields are added in Acrobat, tag them and add tooltips as above before you publish.

Fix it automatically with Includoc

Includoc tags every field automatically, in reading order, and sets the tab order of every page with fields to follow the structure.

Field descriptions are assisted. We write each field's tooltip from the nearby printed label, and you confirm them on the review screen. We can't fix dynamic XFA forms: convert the form to a standard PDF form first, then check it again. For applications and other high-stakes forms, the human-verified tier tests the form with a screen reader.

Upload your PDF to fix this automatically

Free check in seconds. Files are deleted within 24 hours.

Check your PDF

Standards

Standards references: Form fields aren't tagged
Standard or toolReference
WCAG 2.1
PDF/UA-1 (ISO 14289-1)Clause 7.18.4
Matterhorn ProtocolCheckpoint 28-010
PAC wordingWidget annotations in Form tag
Acrobat ruleTagged form fields
Standards references: Form fields have no label
Standard or toolReference
WCAG 2.1
PDF/UA-1 (ISO 14289-1)Clause 7.18.1
Matterhorn ProtocolCheckpoint 28-005
Acrobat ruleField descriptions
Standards references: This is a dynamic XFA form
Standard or toolReference
WCAG 2.1
PDF/UA-1 (ISO 14289-1)Clause 7.15
Matterhorn ProtocolCheckpoint 25-001
Standards references: Check form labels and instructions
Standard or toolReference
WCAG 2.1

For a complete walkthrough, read Forms in PDFs, or check a PDF free to find fields without tags or tooltips.

  • Widget annotations in Form tag

    PAC fails “Widget annotations in Form tag” when fillable fields aren’t tagged as Form. Why it happens with PDF forms and how to fix it in Acrobat.

  • Tab order – Failed

    Acrobat’s “Tab order – Failed” means pages don’t tab through links and fields in structure order. What the setting does and how to fix it in Acrobat Pro.

  • Accessible PDF forms: field labels, tab order, tags and XFA

    Make fillable PDF forms work with keyboards and screen readers: field tooltips, tab order, Form tags, required fields, error messages and the XFA trap.