Search

Create a table

Easily create tables with a /Slash Command or paste data from a CSV file. 

What you'll need

Create a table

Insert tables into Docs, wikis, Chat Channels and direct messages, task and subtask descriptions, text block Dashboard cards, and Notepad.

To create a table:

  • Type /table and press Enter or Return.
  • Paste a table from another location in ClickUp.
  • Paste a table from other apps, including Excel and Google Sheets.
  • ClickUp AI can also generate tables.

Add content to your table

Tables support all kinds of rich content, including rich text and embedded content.

You can use /Slash Commands to create and format content.

Add rich text formatting to tables

To add rich text formatting to tables:

  • Select specific text and choose options from the text toolbar.
  • Click and drag to select two or more cells, then choose options from the text toolbar.

Embed content

Within a cell of a table you can:

  • See link previews and comment previews.
  • Drag and drop images and attachments inline.
    This option is not available in task descriptions, or when using the quick create modal to create a new task or doc.

Use Slash Commands

Within the cell of a table you can use /Slash Commands to use ClickUp AI, embed content, and quickly format text.

Customize the appearance of tables

You can customize how each table appears, including:

  • Adjust column width.
  • Set the table to use the full width and evenly space columns.
  • Reorder columns and rows by drag and drop.
  • Set specific column or row settings including merging columns and rows, setting background colors, using row or column-specific text formatting, and more.
  • Customize the alignment of text in each cell.

Adjust column width

To adjust the column width in a table:

  1. Hover at the left or right side of any column
  2. Click and drag the border.

Screenshot of the arrow you can use to adjust the column size.

Use the full width

To use the full available width and evenly space all columns:

  1. Select one or more cells in a table.
  2. Click the fit container icon.

Screenshot of a table highlighting the fit container button.

The following screenshot displays a table using the full width of a task description:

Screenshot of a full width table in a task description.

Reorder a column or row

  1. Click into the row or column to display the drag handles.
  2. Click and drag the column or row to its new position.
    Screenshot of the drag handle.

Column and row options

Hover over the top of a column or the left side of a row, and click the grab handle to open the options menu.

The following table describes the options available:

Option Description
Add 1 row or column

Add 1 row above or below the selected row.

Add 1 column to the left or right of the selected column.
Merge cells Merge the selected cells.
Background color Set the background color for the cells in the selected row or column.
Text formatting Set text formatting for the cells in the selected row or column, including bold, italics, underline, strikethrough, and inline code formatting.
Alignment Select the vertical and horizontal alignment for the cells in the selected row or column.
Lists Convert the text in the selected row or column to lists, including bulleted list, numbered list, toggle list, and checklist.
Delete Delete the selected row or column.

Align text in specific cells

For content inside a table, you can align the text in one or more cells:

  1. Select the text or cells you want to align.
  2. From the text toolbar, click the alignment icon and select from the available alignment options:
    • Horizontal alignment: left, center, or right.
    • Vertical alignment: top, middle, or bottom.

The following screenshot of a table displays the different alignment options as described in the left column:

Screenshot of a table displaying different alignment options.

Navigate a table with keyboard shortcuts

The following table describes the keyboard shortcuts available to move between and within cells in a table:

Movement Keyboard shortcut
Move down to the end of next cell in the column.
  • Return or
  • Enter

Create a new item in a list.

For example, when a cell has a bulleted list.
  • Return or
  • Enter
Create a new line within a cell.
  • Shift + Return or
  • Shift + Enter
Move across to the next cell in the row. Tab
Move across to the previous cell in the row. Shift + Tab
  •