Confluence Tables and Lists

Tables and lists are the two most commonly used formatting tools in Confluence. Tables organise data across rows and columns. Lists group related items in a readable sequence. Knowing when and how to use each one makes your pages clearer and faster to scan.

When to Use a Table vs a List

The choice between a table and a list depends on how many attributes each item has. One attribute per item suits a list. Multiple attributes per item suits a table.

Decision Diagram

Does each item have MORE THAN ONE attribute?
│
├── YES → Use a TABLE
│         Example: People + Role + Department + Start Date
│
└── NO  → Use a LIST
          Example: A list of tools your team uses

Real Example Comparison

LIST (one attribute — tool names):
• Confluence
• Jira
• Slack
• Figma

TABLE (multiple attributes — tool + purpose + owner):
────────────────────────────────────────────────────
TOOL        PURPOSE             OWNER
────────────────────────────────────────────────────
Confluence  Documentation       Priya Sharma
Jira        Task tracking       Raj Mehta
Slack       Team chat           All staff
Figma       Design mockups      Sam Kapoor
────────────────────────────────────────────────────

Creating a Table

Type /table in the editor and press Enter. A blank table appears. Click inside any cell to type. Press Tab to move to the next cell. Press Tab in the last cell to add a new row automatically.

Table Keyboard Shortcuts

KEY                 ACTION
────────────────────────────────────────
Tab                 Move to next cell (right)
Shift + Tab         Move to previous cell (left)
Enter               New line inside a cell
Tab (last cell)     Add a new row

Table Toolbar Options

Click any cell and a floating toolbar appears. This toolbar controls the table structure.

Table Toolbar Actions

ACTION              WHAT IT DOES
──────────────────────────────────────────────────────────
Insert column left   Adds a column before the selected column
Insert column right  Adds a column after the selected column
Insert row above     Adds a row before the selected row
Insert row below     Adds a row after the selected row
Delete column        Removes the selected column
Delete row           Removes the selected row
Header row toggle    Bolds the first row (marks it as a header)
Merge cells          Joins selected cells into one

Making a Header Row

A header row makes your table immediately easier to read. Click inside the first row, then click the header row toggle in the toolbar. The row turns grey and all text becomes bold — a clear signal to readers that these are column labels, not data.

Without vs With Header Row

WITHOUT HEADER ROW:           WITH HEADER ROW:
───────────────────────────   ──────────────────────────────
Priya  HR     Manager         NAME   DEPT   ROLE
Raj    Eng    Developer       Priya  HR     Manager
Sam    Mkt    Designer        Raj    Eng    Developer
                              Sam    Mkt    Designer
Hard to know what each        Column labels are immediately
column means at a glance.     clear to any reader.

Sorting a Table

Confluence tables support basic column sorting. Click any column header on a published page to sort that column alphabetically or numerically. The sort is temporary — it does not change the stored order of rows.

Bullet Lists in Depth

Type a hyphen (-) followed by a space to start a bullet list automatically. Press Enter to add the next bullet. Press Tab to indent a bullet and create a nested sub-list.

Nested List Structure

• Tools used by the team
   • Design
      • Figma       ← 2nd level indent
      • Adobe XD    ← 2nd level indent
   • Development
      • VS Code
      • GitHub

Use nested lists sparingly. Two levels of nesting is usually the maximum before the structure becomes hard to follow. If you need three or more levels, consider restructuring the content into a table or separate pages.

Numbered Lists in Depth

Type 1. followed by a space to start a numbered list. Confluence numbers the items automatically — you never type numbers manually. This matters because Confluence renumbers the entire list if you insert, move, or delete an item.

Automatic Renumbering Benefit

ORIGINAL LIST:          AFTER INSERTING STEP 2a:
1. Open the app         1. Open the app
2. Click Settings       2. Sign in to your account  ← new step
3. Save changes         3. Click Settings
                        4. Save changes
                        ↑ Renumbered automatically

Task Lists

Confluence supports task lists — bullet lists with checkboxes. Type [ ] to add a checkbox that teammates can tick off on the published page.

Task List Example

Onboarding checklist:
☐ Set up laptop
☑ Create email account    ← completed
☐ Complete compliance training
☐ Meet the team

Task lists work well on meeting notes pages. Add action items as a task list, assign each one with an @mention, and teammates tick off tasks directly on the page as they complete them.

Combining Tables and Lists

You can place a list inside a table cell. Click inside a cell and type your hyphen (-) to start a bullet. This works for cells that need multiple values without creating extra rows.

List Inside a Table Cell

NAME       SKILLS
──────────────────────────────────────────
Priya      • HR strategy
           • Training delivery
           • Policy writing

Raj        • Python
           • API development
           • Database design

This pattern is useful when one column naturally contains several values per person or item, and adding extra rows would break the table's readability.