PDF Remediation: How to fix tables, Part 1

Sometimes, when we view a PDF table with Acrobat Pro's Table Editor tool, the red/purple lines that delineate the table cells don't align correctly.

Here's one way to correct this problem so that it doesn't throw off screen readers and other assistive technologies.

The problem: Acrobat's Table Editor doesn't identify the cells correctly

When a table doesn’t appear correctly in Acrobat’s Table Editor, the red/blue outlines and shading on the table cells don’t match the actual structure.

Expecting to see something like this:
Sample table viewed in Acrobat's Table Editor tool. The red and blue cells and lines correctly match the table's structure.

You may see something more like this:
Sample table that doesn't indicate the cell matrix correctly. Some cells appear to be merged in Table Editor when they aren't merged in the Tag tree.

This error prevents remediators from selecting the <TH> cells to add the required Scope and Span properties to them. It also causes the table to be mis-read by screen readers.

How to correct the problem

Instead of using Acrobat’s Table Editor, edit the <TH> and <TD> tags manually in the Tags Panel.

First, check that each cell in the table is correctly tagged as <TH> or <TD>.

  1. In Acrobat’s Tags panel, expand the <Table> tag and examine each <TH> and <TD>. Column Headers and Row Headers should have <TH> tags, and the remaining data cells should have <TD> tags.
  2. Modify any erroneous tag either by right-clicking on it and selecting Properties / Tags / Type, or by simply editing the tag itself.

Next, modify the attributes of each cell’s tag in the Tags panel. 

For each <TH> and <TD> cell:

  1. Right-click the cell and select Properties.
  2. Click the Edit Attribute Objects button.
  3. Click the New Item button, which will create /Attribute Object 1  <<Dictionary>>
  4. Click its + (plus sign) to open it.
  5. Click the /O  /Layout entry to highlight it and click the Change Item button.
  6. Change Layout to Table and click the OK button.

If the cell is a <TH> cell, set its Scope and Span settings

  1. Click on /Attribute Object 1  <<Dictionary>> to highlight it and click on the New Item button.
  2. In the Key: box, type in Scope
  3. In the Value: box type in either Column or Row, as appropriate, and select Name in the Value Type dropdown. Click OK.

If this <TH> cell spans more than one row and/or column:

  1. Click on /Attribute Object 1  <<Dictionary>> to highlight it and click on the New Item button.
  2. In the Key: box, type in either RowSpan or ColSpan as appropriate.
  3. In the Value: box, type in the appropriate number of cells spanned in that direction, and select Integer in the Value Type dropdown. Click OK.
  4. If both rows and columns are spanned, repeat steps 1 through 3 for the opposite span.

This method won't clear up your table's appearance in Acrobat's Table Editor, but it should now read correctly with screen readers. Before publishing the PDF, be sure to test your table with screen readers and other AT (assistive technologies.)

Check this blog for other tutorials on remediating PDFs.

PubCom - Signature

Logo, Pub Com dot com.

PubCom creates solutions for accessible documents

We're technologists for accessible design and publishing. We help agencies, academics, authors, designers, and publishers build accessibility into their documents from start to finish.

  • Our courses about Sec. 508 topics are the best-in-class, but we also offer training in traditional desktop publishing, digital media, and office documents.
  • Our consulting services can help you develop an accessible workflow that works.
  • We also provide remediation services for your existing documents, but we prefer to "teach you how to fish" and make your documents so accessible that they don't need remediation.

We've been in the publishing industry for eons and our first classes in accessible documents were held in 2001, soon after Sec. 508 went into effect and WCAG 1 was released.

Summary: We know publishing, from editorial to design to distribution. And we focus on helping you maximize your technology, streamline your workflow, and seamlessly build accessibility into your publishing workflow.

 See how we work with you.

Sign up for our upcoming classes, or we can bring a custom curriculum to your agency to train your writers, editors, desktop publishers, webmasters, and accessibility technicians. We conduct traditional classroom courses and live online sessions.

We’re committed to making documents accessible for the nearly 35% of our fellow citizens who have disabilities that make it difficult for them to use computer technologies. .

Cartoon of a happy guy, fishing.We teach how to make your documents accessible.

Let us know how we can help you fish!

— Bevi Chagnon
CEO and Founder, PubCom