How to make checkbox accessible on static pdf rendered using AEM form API | Community
Skip to main content
Level 4
March 30, 2026
Question

How to make checkbox accessible on static pdf rendered using AEM form API

  • March 30, 2026
  • 1 reply
  • 22 views

Hi,

I have come across a problem, where the checkbox which is on Static tagged PDF, is not read correctly by screen readers such as voice over.

It reads the title, but not if the checkbox is checked /unchecked.

 

The static PDF which is tagged, as cross mark on the check box, but voice over is not able to recognize it and read it aloud. hence it reads only the title of the checkbox.

 

Please note: The static pdf is rendered using outputservice.generatePDF API and is tagged. 

NVDA screen reader, is reading check box  unavailable  checked  read only, after the title is read aloud. But Voice over and acrobat pro read aloud is not able to recognize this.

Anyone seen this issue before.?

1 reply

Adobe Employee
March 30, 2026

Hi ​@SmrithiGo,

Thank you for sharing the details and examples of the issue you are seeing with checkboxes in your static tagged PDF.

I have analyzed the behavior you described:

  • The PDF is generated as a static, tagged PDF using the OutputService.generatePDF API.
  • Screen readers such as NVDA announce the checkbox as “checkbox unavailable checked read only” after reading the associated label.
  • However, VoiceOver and Acrobat Read Out Loud only read the checkbox label/title and do not announce whether the checkbox is checked or unchecked.

This difference is related to how each screen reader interprets the information exposed by the PDF:

  • In the static PDF, the visual “X” inside the checkbox is represented as a graphical element (a path), not as explicit text such as “checked” or “unchecked” in the PDF’s tag structure.
  • NVDA uses additional heuristics and internal form metadata from Acrobat to infer and announce the checkbox state.
  • VoiceOver and Acrobat Read Out Loud rely more heavily on the PDF’s tag structure and the presence of explicit text or accessible properties for the checkbox state. Since the state is not exposed as text (only as a graphic), they read the label but do not announce it.

Because of this, VoiceOver and Acrobat Read Out Loud are not able to reliably announce the checkbox state for static, flattened checkboxes generated in this way.

We are already aware of the issue and the issue has already been fixed and is expected to be released at part of SP25. The fix improves NVDA behaviour but doesn't change the fundamental fact that in a static document the checkbox "X" is still just Path geometry, with no value text for VoiceOver to read.

Thanks
Pranay

 

SmrithiGoAuthor
Level 4
March 31, 2026

@Pranay_M That’s good to hear that the fix is already ready and will be released as part of SP25. Is there any way, it can be made available on SP 21 too?

Adobe Employee
March 31, 2026

Hi ​@SmrithiGo,

Unfortunately, It is not possible for us to deliver the fix for SP21.

Thanks
Pranay