Working with Tables

Added by Vidya Madabushi, last edited by Sarah Maddox on Oct 17, 2007 (view change)

All Versions

Confluence 2.9 Documentation

You can use Confluence wiki markup or the Rich Text editor to create tables. Below are some guidelines on using wiki markup to create tables.

Confluence allows you to create two types of tables.

Table Type 1

Allows you to create a simple table with an optional header row. You cannot set the width of the columns in this table.
Use double bars for a table heading row.

What you need to type:

||heading 1||heading 2||heading 3||
|cell A1|cell A2|cell A3|
|cell B1|cell B2|cell B3|

What you will get:

heading 1	heading 2	heading 3
cell A1	cell A2	cell A3
cell B1	cell B2	cell B3

Currently, Confluence does not support nested tables.

You can also use a vertical header.

What you need to type:

||heading 1|col A1|col A2|col A3| 
||heading 2|col B1|col B2|col B3|

What you will get:

heading 1	col A1	col A2	col A3
heading 2	col B1	col B2	col B3

Table Type 2

This method allows you to specify the width of the columns in the table.

What you need to type

{section:border=true}

{column:width=30%}
Text for this column goes here. This is  the smaller column with a width of only 30%.
{column}

{column:width=70%}
Text for this column goes here. This is  the larger column with a width of 70%.
{column}

{section}

What you will get

Text for this column goes here. This is the smaller column with a width of only 30%.

Text for this column goes here. This is the larger column with a width of 70%.

For more details please see the Column Macro and the Section Macro.

Advanced Formatting

Colour and Other Formatting

To add colour and other formatting to your tables, you can use the Panel Macro within columns.
More table-formatting options may be available if your Confluence administrator has installed additional macros.

Lists

Here's an example of how to embed lists in a table:

What you need to type

||Heading 1||Heading 2||
|* Item 1
* Item 2
* Item 3|# Item 1
# Item 2
# Item 3|

What you will get

Heading 1	Heading 2
Item 1 Item 2 Item 3	Item 1 Item 2 Item 3

Comments (37)

Hide Comments Show Comments
Collapse All Collapsing… Expanding… Expand All
Add Comment

Jun 13, 2006

heike says:
Hiho, how do I set background color in tables? I
Hiho,

how do I set background color in tables? I
- Permalink
- Reply
1. May 09, 2007
  
  Guy Fraser says:
  The easiest way would be to install the Content Formatting Macros plugin and the...
  The easiest way would be to install the Content Formatting Macros plugin and then either build a custom table with the new macros or use the bgcolor macro to wrap your table.
  
  LOL, the CAPTCHA word for this comment is "tabling" heheh
  Permalink
  
  Reply
  1. Jun 06
    
    Tiffany Bartlett says:
    I'm trying to get an empty cell to have a background color. If I use |...
    I'm trying to get an empty cell to have a background color. If I use | {bgcolor:blue} {bgcolor} | it doesn't color the cell unless there is text between the two. Any idea how to get a blank cell with a background color?
    
    Thanks,
    
    Tiffany
    
    Permalink
    
    Reply
    1. Jun 09
      
      Mei Yan Chan says:
      Hi Tiffany, There isn't any workaround to it unless you specify a character. A...
      
      Hi Tiffany,
      
      There isn't any workaround to it unless you specify a character. Alternatively, you can try checking out for more workaround here:
      
      http://www.adaptavist.com/display/USERGUIDE/bgcolor+macro
      
      Regards,
      Mei
      
      Permalink
      
      Reply
    2. Oct 08
      
      Anonymous says:
      Hi, you may want to try this: | | add as many spaces ...
      
      Hi,
      
      you may want to try this:
      
      |
      
      |
      
      add as many spaces as you need, the table cell will stay empty.
      
      Regards
      
      Permalink
      
      Reply
      1. Oct 08
        
        Anonymous says:
        Ups, sorry, this is what I wanted to type: |{bgcolor:blue}  {bgcolor}...
        
        Ups, sorry, this is what I wanted to type:
        
        |{bgcolor:blue}  {bgcolor} |
        
        Permalink
        
        Reply
Feb 20, 2007

Joanne Webb says:
In Table Type 1, column width seems to be determined by the longest non-breaking...
In Table Type 1, column width seems to be determined by the longest non-breaking line.

To force columns to be wider, use underscores in the column header, e.g (there are probably other ways - but this worked).

This is column one row one This is column two This is column three This is column four This is column five

This_is_column_one_row_one This is column two This is column three This is column four This is column five

To force them to be narrower, use SHIFT+ENTER to break the longest line with no spaces, (or other punctuation Confluence can break lines in tables on - don't know the list), e.g. URLs

http://confluence.atlassian.com/display/CONF20/Working+with+Tables http://confluence.atlassian.com/

[http://confluence.atlassian.com/display/
CONF20/Working+with+Tables] http://confluence.atlassian.com/
- Permalink
- Reply
May 01, 2007

Mohammed Alam says:
A feature request has been created in Jira which can be tracked http://j...
A feature request has been created in Jira which can be tracked

http://jira.atlassian.com/browse/CONF-6482

Please add a watch to this issue and feel free to add comments and vote for it there.
- Permalink
- Reply
May 04, 2007

Haider says:
Can a cell in a table span two columns for a row column1 ...
Can a cell in a table span two columns for a row

column1 column2

row1 cell 1 row1 cell2

row2OnlyOneCell-spanned
- Permalink
- Reply
1. May 10, 2007
  
  Todd E Rinaldo says:
  I second this request. It should be as simple as: || Title Spanning all colum...
  I second this request. It should be as simple as:
  
  || Title Spanning all columns || || A || B || C || | 1 | 2 | 3 |
  
  Confluence should assume since there's no emptly line that the table should be all one width.
  Permalink
  
  Reply
  1. May 10, 2007
    
    Rosie Jameson says:
    You may like to vote for this issue: http://jira.atlassian.com/browse/CONF-3808
    You may like to vote for this issue: http://jira.atlassian.com/browse/CONF-3808
    
    Permalink
    
    Reply

Jan 08, 2008

Iain Donald says:

Hi Does anybody know how to put a line break in a table to separate the data, b...

Does anybody know how to put a line break in a table to separate the data, but keep the subsequent tables all of the same width?

So it would look something like:

H1	H2	H3
Text1	Text2	Text3

Text4	Text5	Text6
etc	etc	etc

Thanks.

Permalink

Jan 08, 2008

James Mortimer says:
I wish. you could try the following (all messy) solutions use {div:style=widt...
I wish. you could try the following (all messy) solutions
- use {div:style=width:30px} tags with a fixed width in the first row of each block of columns.
- set a fixed column width for ALL columns using td.ConfluenceTd in css using {style} macro
- use a blank row to separate data instead of starting a new table. there might be a css trick to hide the borders
- try using the {table} {tr} {td} table syntax, which are more configurable.
- Permalink
- Reply
1. Jul 23
  
  Glenn Brunette says:
  I am using the table syntax, but it appears as though the Rich Text editor do...
  I am using the
  table syntax, but it appears as though the Rich Text editor does not understand this format? Instead of rendering the table, it just spits out the macros. Is this a known bug? Is there a workaround? I like the flexibility of the
  
  syntax but the lack of Rich Text edit for my contributors is creating a real problem. Thoughts?
  Permalink
  
  Reply

Mar 06, 2008

Bob Swift says:

Use the CSV Macro h1h2h3text1text2text3 text4text5text6 {csv} h...

Use the CSV Macro

h1	h2	h3
text1	text2	text3

text4	text5	text6

{csv}
h1, h2, h3
text1, text2, text3

text4, text5, text6
{csv}

Permalink

Feb 06, 2008

Thom W Gray says:
Have you tried the Table Plus macro?
Have you tried the Table Plus macro?
- Permalink
- Reply

Mar 06, 2008

Anonymous says:

Is it possible to nest one table inside a cell in another table using either ric...

Is it possible to nest one table inside a cell in another table using either rich text or wiki markup?

Permalink

Mar 06, 2008

Bob Swift says:

Use the CSV Macro h1 h2 text1text2text3text4 more || h1 |...

Use the CSV Macro

text1	text2
text3	text4

Working with Tables

Table Type 1

Table Type 2

Advanced Formatting

Colour and Other Formatting

Lists

RELATED TOPICS

Labels

Comments (37)

heike says:

Guy Fraser says:

Tiffany Bartlett says:

Mei Yan Chan says:

Anonymous says:

Anonymous says:

Joanne Webb says:

Mohammed Alam says:

Haider says:

Todd E Rinaldo says:

Rosie Jameson says:

Iain Donald says:

James Mortimer says:

Glenn Brunette says:

Bob Swift says:

Thom W Gray says:

Anonymous says:

Bob Swift says: