Confluence pages can include multi-row and multi-column tables. You can highlight cells, rows and columns in different colours. When viewing the page, people can sort the table by clicking the column headers.

Insert a table

To create a table:

  1. While editing the page, place your cursor at the point where you want to insert the table.
  2. Choose Table on the toolbar.
  3. A dropdown menu will appear, showing a table with a variable number of rows and columns. Click in a cell to set the number of columns and rows for your table.
  4. Add content and more rows and columns as needed. See below for guidelines on what you can do with your table in the editor.

On this page:

Related pages:

Screenshot: Inserting a table with 3 rows and 3 columns

What you can do with your table in the editor

While editing a page, place your cursor inside a table to see the table toolbar. Here's a summary of the tools:


  • Insert rows before or after the current row
  • Delete the current row
  • Cut, copy and paste the current row
  • Mark a row as a header row (shaded with bold text)


  • Insert columns before or after the current column
  • Delete the current column
  • Cut, copy and paste the current column
  • Mark a column as a header column (shaded with bold text)


  • Merge selected cells
  • Split selected cells
  • Change cell colour


  • Delete table
  • Add a numbering column to automatically number each row

Shortcut keys



Mac OS X


Copy the current table row, or the selected rows.



Insert a table. (Opens the Insert Table dialog.)



Paste the table rows from your clipboard, placing them above the current row.



Cut the current table row, or the selected rows.


Alt+Up ArrowAdd a row above the current row.Alt+Up Arrow
Alt+Down ArrowAdd a row below the current row.Alt+Down Arrow

For more editor keyboard shortcuts, see Keyboard shortcuts.

Sort the table in view mode

When readers view a table on a page, they can sort the table by clicking the sort icons in the header row.

Screenshot: A colourful, sortable table

Sticky table headings in view mode

In some instances table header rows will stick to the top when you're viewing a page, making those really long tables easier to read. There are a few exceptions though. Table headers aren't sticky when:

  • the space is using the documentation theme.
  • your table is inside a page layout, or inside another table.
  • your table has no header row or there are cells in the top row that aren't marked as headers.
  • your table has a header column, instead of a header row, and scrolls horizontally.
  • your table contains another table, that has its own header row. 
Last modified on Dec 2, 2015

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.