Add Tables


Tables allow you to display data in rows and columns. You can create tables on your Open Berkeley site, and you should make sure that any tables you create are accessible to people with disabilities. Use tables for tabular data, not layout (i.e., do not use a table in order to only display images in rows). If you need text and images to align a certain way on a page, anyone with the Site Builder or Widget Editor role can use Layouts and Widgets to achieve this instead.

Tables should be used to display data in rows and columns with proper table headers (column headers, row headers, or both, depending on the data table) as a general best practice and for accessibility. 

Important Notes

  • Avoid nested tables, as they may have accessibility and performance issues.
  • Responsive tables:
    • Properly-constructed tables will be "responsive" for optimal display on all devices, including mobile/tablet.
    • Due to the responsive theme, links should not be added to header cells.
    • It is not recommended to disable the responsive table functionality (we recommend that non-standard tables be fixed instead to align with best practices for accessibility and responsive design). However, if you need to disable the responsive table functionality, please see Responsive Tables.

Use tables correctly for accessibility

Using tables correctly is an accessibility best practice (and the UC has an accessibility policy that states that your websites and website content need to be accessible). See "Use tables for tabular data, not for layout" from the "Top 10 Tips for Making Your Website Accessible" page on the Web Accessibility website for more information.

How to make sure your table is accessible

A blind or low-vision person may visit your website using a "screen reader." To ensure that a screen reader can properly associate the data between the rows and columns, you should make sure to add table headers with the appropriate table scope.

If you are new to creating accessible tables, make sure to see the "Table Header" and "Table Scope" sections further down on this page.

How to add a table

To add a table, select the "Insert/Edit Table" button from the bottom of the editing toolbar:

A window will pop up, which will allow you to specify the desired number of rows and columns for your table.

Important Note

At this time, the other editing options available in this window (cell padding, cell spacing, width, etc.) will NOT work; use only the options for Columns, Rows, and Table Caption (optional):

Valid WYSIWYG table options

After adding your table, you can add and delete columns and rows, as well as merge and split cells, using the editing toolbar:

Table WYSIWYG additional buttons

Table header

What is a "table header" and why is it important?

The "table header" is the main row or column of a table that informs site visitors of the main "categories" of a table. For example, if you're putting together a directory of contact information, and the first row is "Name," "Position," and "Email," then that row would be the table header.

To improve accessibility for screen readers, it may also be necessary to designate the first column (and/or first row) as a table header.  You will need to assign the appropriate "table scope" for your column headers and row headers. See the section below on "table headers" if you are unfamiliar with the correct way to add table scope.

This is helpful from an overall usability perspective, but it is also highly recommended that a header be added to your table as a best practice for accessibility. When a header is designated, a screen reader user (see "Use tables correctly for accessibility," above) will hear the information in this header row as the main "categories" for a table. 

When you create a new table on your Open Berkeley site, if the individual cells in the first row contain 40 characters or fewer, then that row will automatically be designated as the table header.

How to add a Table Header to your table

Generally speaking, for a standard data table (such as a Directory), the first row should be the header row for the whole table, but you can also designate other rows/columns as headers if needed.

If the cells in your first row contain more than 40 characters, please be sure to designate a row or column as a header. To do this, select the row/column that you would like to be used as the table header, then select the "Table Cell Properties" button, then for "Cell Type," select "Header" from the drop-down menu:

If a Table Header is added, you should also select the appropriate Table Scope (see below).

Table scope

What is a "table scope" and why is it important?

A Table Header (see above) is just the starting point for making a table accessible (see "Use tables correctly for accessibility," above). For most tables (especially tables with many rows and/or columns), you will also want to define a "scope" in order to provide more helpful information for screen reader users. Essentially, defining a scope within a column or row will help properly associate the data in a column with the corresponding data in a row within your table.  Visit the WebAim Creating Accessible Tables web page for additional information.

Adding Table Scope to Column Headers

Many basic tables will require Column Headers in the first table row.  For example, if you're putting together a directory of contact information, and the first row is "Name," "Position," and "Email," then that row would be the table header.

To add the scope, select the cell where you would like to start the table scope, then select the "Table Cell Properties" button:

Table Column Headers Example

Since the first row in this table should be Column Headers, you will want to define the scope to "Column" and then select "Update all cells in row" to apply that scope to the entire first row:

Table Column Scope Example

Applying a table header to all cells in the first row with a column scope will result in your first row becoming a header for all visitors (including those who use screen readers):

Table Column Headers and Scope Result

Adding Table Scope to Row Headers

If your table is anything beyond a basic table, you may also need to add row headers to improve the accessibility for screen readers.

For example, in our table above, if you had many more people in your Contact Directory, and a screen reader user started reading down the Position column, the screen reader user might hear "Faculty, Staff, Staff, Faculty, Faculty, etc." and have no idea who that "Position" information is associated with.

In such a case, it improves accessibility to add Row Headers to your first column of data as well, in this case the names themselves.

To do so, select the additional cells where you want to add a table row header.  In this example, we would select the first cell in rows 2 and 3, i.e., "Jane Doe" and "John Doe."  Then select the "Table Cell Properties" button and assign the scope to "Row" for the selected cells:

Table Row Headers and Scope Example

Applying a table header to the additional cells with row scope will result in your first column also becoming a header for all visitors, which will improve accessible for those who use screen readers:

Table Row Headers and Scope Result

Table caption

The "table caption," if used, will show up at the top of the table, and will look a bit like the a "title" for the table. A table caption can be helpful as a brief description of what sort of data will be found in the table.

To add a table caption, add the table first, then while the table is selected, click the "Insert/Edit Table" button again, and check the box for "Table Caption," then click "Update."

The table caption field will become available at the top of your table, and you can add the table caption text accordingly.

Table design/style

Tables in Open Berkeley will automatically have some simple styling in order to help improve readability. If desired, some of this styling can be removed by a Site Builder (see Heading, Paragraph, and Table Classes).