Working with Tables

Proper table structure is important to accessibility. Among other issues, poorly constructed tables cannot be properly read by screen readers for the visually impaired.

Appropriate Content

Tables should only be used for tabular data. NEVER use a table for layout. Try to simplify or split up tables that are complicated or large. Avoid incorporating any non-tabular data in a table. If the table has a title, you should add that title as a Table Caption.

To give your table a title:

  1. Select your table, then click Inserts a new table (Screenshot of Inserts New Table icon) to modify that table's properties.
  2. Check the Table caption check box.

    Screenshot of Table Caption
  3. A new row has been added to the top of your table. Type the title of your table in that new row.


If your content contains a table, you have the option of editing the Table row properties (Table_rowprop) or Table cell properties (Table cell prop). Please note that the background color, border, width, height, etc., of the table will be determined automatically by our templates if those properties are left blank. Unless the content in your table specifically requires formatting that is different from our default formatting, please leave those properties blank.


Entire rows and individual cells can both be marked up to be headers. Every table should include headers. By marking up your headers properly, you ensure that they are formatted correclty and fully accessible.

Marking up only a row as a header is not enough. All individual header cells must be marked up as such, whether or not they are also in a row that is marked up as a header.

For data tables that have two or more levels of row or column headers, add scope attributes to your header cells to clarify which parts of the table those headers correspond to.

To mark up header cells:

  1. Select one or more cells in the editor, then click Table cell properties (Table cell prop).
  2. For Cell type, select Header.

    Screenshot of Cell Type

To add scope attributes to header cells:

  1. Select the cell in the editor, then click Table cell properties (Table cell prop).
  2. For Scope, select Column or Row.

    Screenshot of Scope

To mark up header rows:

  1. Select the row in the editor, then click Table row properties (Table_rowprop).
  2. For Row in table part, select Table Head.

    Screenshot of Row in Table Part