This page last changed on Dec 17, 2009 by ggaskell.

The column macro allows you to define a set of columns across a page.

A set of columns must be defined within a vertical 'section' of a page. Hence, to display a set of columns correctly across a page, each column in the set must be inserted within a single pair of section macro elements. Furthermore, each column in the set is defined as a pair of column macro elements.

Once you have defined your set of columns within a pair of section macro elements, you can add content to each column by inserting your content within the body of each pair of column macro elements.

The following example in Wiki Markup, shows a set of two columns defined across a section of a page,

{section:border=true}
{column}The content of column one is entered within the body of the first set of column elements here.
{column}
{column}The content of column two is entered within the body of the second set of column elements here.
{column}
{section}

which renders on the page like this:

The content of column one is entered within the body of the first set of column elements here.

The content of column two is entered within the body of the second set of column elements here.

On this page:

Usage with the Macro Browser

To insert the column macro into a page using the Macro Browser,

  1. Open your desired Confluence page or blog post, then click the 'Edit' button. The page or blog post opens in edit mode.
  2. Click the Macro Browser icon on the toolbar. The macro browser window opens in the middle of the screen in 'macro selection' mode.
  3. Scroll through the list of macros. Alternatively, start typing part of the name of your desired macro into the search box at the top right of the macro browser window. Macros with a matching name will appear in the main pane.
  4. Click on the desired macro to access its parameters and preview parameter changes ('preview mode').
  5. Set the macro parameters to your requirements. If desired, you can preview these changes by clicking 'Refresh'.
  6. Click 'Insert' to put the macro into the page.

You can also insert macros via autocomplete. For more information, see Using Autocomplete in the Rich Text Editor.


Once you've found the column macro, click 'insert' to add it to your page.

One or more column macros must be inserted within a section macro to be displayed correctly on a page.

Usage with the Wiki Markup Editor

What you need to type What you will get
{section}
{column}Column one text goes here{column}
{column}Column two text goes here{column}
{section}

Column one text goes here

Column two text goes here

Parameters

Parameters are options that you can include in Confluence macros to control the content or format of the macro output. The table below lists relevant parameters for this macro.

Parameter names are different in the macro browser and in wiki markup. Below we show the macro browser parameter names in bold text, and the equivalent wiki markup parameters in (bracketed) text. If we do not show any parameter name for the wiki markup, then you should leave out the parameter name and simply include the parameter value as the first parameter, immediately after the colon (:).

Parameter Required? Default Description
Column Width
(width)
no 100% of the page width, divided equally by the number of {column}s in the {section} The width of the column. Can be specified either in pixels (e.g. '{column:width=400px}') or as a percentage of the available page width (e.g. '{column:width=50%}')
RELATED TOPICS

Working with Macros
Working with Tables

Take me back to the Confluence User's Guide.

Document generated by Confluence on Jul 09, 2010 01:08