Skip to main content

How to use JamA11y

Learn how to upload, convert and export accessible documents using JamA11y.

Written by Kieran O'Reilly

To get started, navigate to the JamA11y tab in the portal and select "Upload files"

Arrows point to the JamA11y tab and the "Upload files" button

You'll then have two options depending on your document type:

Option 1: To add accessibility features without changing the layout or visual appearance of your PDF, select the option "Remediate a PDF". This adds tags, alt text, and metadata to bring the file in line with the PDF/UA standard.

The "Remediate a PDF" option is selected

Once processing is complete, select "Download PDF" to save your PDF.

The JamA11y dashboard with a file context menu open, showing options for View, Remediate, Download PDF, and Delete."

Option 2: For documents with STEM content, complex layouts, or scanned and handwritten content, select "Generate Alternative Formats". This converts your file to WCAG AA 2.2 compliant HTML and more formats.

A drag-and-drop area and two conversion options: 'Remediate a PDF' and 'Generate Alternative Formats', with 'Close' and 'Remediate' buttons at the bottom.

Once processing is complete select "View"

The JamA11y dashboard with the 'more actions' menu open, showing options for View, Export and Delete.

This opens the document editor to manually review and fine-tune your alternative formats. The editor includes standard text editing tools, alongside several dedicated remediation features:

To add alternate descriptions to images, select the image and chose "Image options". From the image options menu, you can write your description, or mark the image as decorative.

An arrow pointing to the image options button

The image options dialogue open, with the alternative description text box selected

Select "Show Original PDF" to view your original document side-by-side with the editor, making it easier to fine-tune the accessible versions of the document.

An arrow pointing to the "Show original PDF" button

Click on an equation or formula, or select the "MathType" icon from the toolbar to open the MathType equation editor.

The MathType equation editor open in a panel on the right, alongside a tooltip showing 'Insert a math equation - MathType' in the toolbar.

Select "Show Extracted Assets" to view and reinsert images and links that were present in the original PDF.

The Extracted Assets panel open on the right, showing two extracted images from the original PDF, each with 'Insert at Cursor' and 'Copy URL' buttons.

To review your document's accessibility against WCAG 2.1 AA standards, select "Accessibility Checker".

The cursor hovering over the accessibility checker toolbar button

When ready, export your accessible document as HTML, DOCX, PDF/UA, BRL or MP3.

An arrow pointing to the more actions menu. The menu shows options Export to HTML, DOCX, PDF/UA, BRL and MP3..

Video Guides:

Did this answer your question?