Write articles

Add tables

Tables make comparisons and reference information easy to scan: plans side by side, settings and what they do, error codes and their fixes.

Who can do this: Owners, Admins and Editors · Plans: All plans

Add a table

  1. On an empty line, type /table and press Enter. A table with three rows and three columns appears. The first row is the header.

  2. Click in a cell and type.

  3. Press Tab to move to the next cell, or Shift+Tab to go back. Pressing Tab in the last cell adds a new row.

Screen recording. Type /table and press Enter. Type in a cell, press Tab to move to the next one.
Tab moves you from cell to cell.

Add or remove rows and columns

Click in any cell and the table toolbar appears:

Button

What it does

Columns

Add column before, Add column after or Delete column.

Rows

Add row before, Add row after or Delete row.

Merge or split cells

Joins the cells you've selected into one, or splits a merged cell again. Drag across cells to select them.

Toggle header row

Turns the header style on or off for the first row.

Toggle header column

Turns the header style on or off for the first column.

Delete table

Removes the whole table.

To change a column's width, drag the border between two columns.

How tables look to readers

Tables fill the width of the article. On a phone, a table that's too wide scrolls sideways inside the article, so the rest of the page stays readable.

Tips for good tables

  • Use tables for data that compares or lists things, not to lay out a page. Screen readers read a table cell by cell.

  • Give every column a short header, so readers know what they're looking at.

  • Keep cells short. A few words or a number reads well; a paragraph does not.

  • The fewer the columns, the less readers on a phone have to scroll sideways. Split a wide table into two.

Was this article helpful?

Recent Articles

Articles you view will appear here.

    Comments

    Be the first to comment.

    This is just a preview of the comment. It needs to be approved first in order to appear for everyone.