Keep information organized and make documenting data easier by adding a table to your page.

You can add tables to better organize your information in a GitBook page. As you would expect, you can add and remove columns, set the type of data in a column, choose text alignments, and much more.


Ace AI – Design

In progress


Discrete Data – API


Table block options

When you open the Options menu to the left of a table block, you’ll have a number of options to change the apperance and manage the data inside the table:

  • Table/Cards: Choose to display your data as either a table block or a cards block. GitBook populates both these blocks using the same data, so you can switch between them depending on the look and design you want.

  • Add column: Add a new column to the right of your table. You can choose column type using the menu, or just click Add column to add a text column.

  • Insert row: Add a new row to the bottom of your table.

  • Show header: Hide or show the top totle row of your table. Depending on the data you’re display, you may not need a title row in your table, so you can disable it here.

  • Reset column sizing: If you’ve changed the column widths, this will reset them all to be equal again.

  • Visible columns: Choose which columns are visible and which are hidden. If you have hidden columns in your table, this menu is where you can make them visible again.

  • Full width: Make your table span the full width of your window. This is great for tables with lots of columns.

  • Delete: Deletes the table block and all of it’s content.

Changing a column type

Depending on the data you want to display, you can set table columns can have different data types. These add formatting, embellishments or restrictions to every cell in the column:

  • Text: A standard text column, with standard formatting support.

  • Number: A number column, with or without floating digits.

  • Checkbox: A checkbox on each line that can be checked or unchecked.

  • Users: You can add the name and avatar of a member of your organization. This can be single-choice or multiple-choice.

  • Files: You can reference a file in the space. You can upload new files when populating cells in the column.

Resizing columns

Hover over a column’s edge and drag to resize it. GitBook stores column sizes as a percentage of the overall width, which allows for relative sizing based on the overall width of the table.

Scrolling tables

Tables that are wider than the editor container will be horizontally scrollable.

Column options

Row options

  • Open row: Open the row in a modal that shows all of its data. Here you can quickly change row types, edit data, and see data in hidden columns.

  • Insert above/below: Add a new row above or below the currently-selected row.

  • Add column: Add a new column on the right of the table.

  • Delete row: Permanently remove all the data in the row from your table.

Images in tables

When you click into a table cell, you can hit the / key to insert images. Note that this will not work in the header row.

Representation in Markdown

# Table

|   |   |   |
| - | - | - |
|   |   |   |
|   |   |   |
|   |   |   |

Last updated