Section Macro

Used with the Column macro to define columns on a page. See  Working with page layouts and columns and sections.

Code examples

The following examples are provided for advanced users who want to inspect or edit the underlying markup for a Confluence page. 

Macro name: section

Macro body: Rich text, consisting of one or more Column macros.

Parameter name Required Default Parameter description and accepted values


No False If the value is true, the columns in this section will have a dashed border.

Storage format example

The following example shows a section and column macro together. 

Wiki markup example

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

21 Archived comments

  1. User avatar


    Would be great if these section could be nested into each other! That would be very helpful to design a page...

    05 Sep 2008
    1. User avatar

      Azwandi Aris [Atlassian]

      Hi there,

      The bug report CONF-2445 addresses this issue. However, due to the non-differentiable opening/closing macro tags, this is not yet possible in Confluence. However, you can try to use a standard table markup inside the section macro, as suggested in the report. Hope this helps.


      08 Sep 2008
  2. User avatar

    John Rocha

    Is there a way to make the data in a column appear at the top of the column?

    I am attempting to crete a table where rowX in column 1, spans 4 rows in column 2, but I don't want the data in the stradled row to be in the middle, I want it at the top. Moreover, we have a huge ogranization, and some want it in the middle and some want it at top, so changing the CSS or global config for this isn't a viable option.



    23 Oct 2008
    1. User avatar

      Ming Giet Chong

      Hi John,

      Could you please raise a support ticket via Besides, try attaching a sample screen shot layout to the ticket that address your requirement? That could help us for a better understanding to this issue. Thanks.


      31 Oct 2008
  3. User avatar

    Christopher Schaller

    section macro provides a reliable way to nest tables, however a section inside a table will always have a border:

    Standard Section, no border

















    11 Aug 2009
    1. User avatar

      Zed Yap [Atlassian]

      Hi Christopher,

      I have created a bug report on this:

      Please add your comments to the discussion and add yourself as a watcher for future updates.
      Also, please bear in mind the following document on how we schedule features for inclusion in our products:
      How we approach fixing bugs.

      Hope that helps.
      Best rgds

      12 Aug 2009
  4. User avatar

    Eduardo F. Sandino

    Hi, i saw that when using the

    macro always is rendered as a table with cellpadding="5". There is a way to avoid this ?

    <table width="100%" cellspacing="0" cellpadding="5" border="0">

    11 Feb 2010
  5. User avatar


    Sections and columns don't export properly to PDF - is there a fix?

    15 Mar 2010
    1. User avatar

      Sashidaran Jayaraman [Atlassian]


      I guess you are encountering this bug. However, there's a workaround that I just found out that worked for me. Perhaps you can try that.


      16 Mar 2010
  6. User avatar


    +1 for nested sections.  I'd really like to use a section macro within a template but can't reliably do that without nesting.

    30 Mar 2010
  7. User avatar

    Chad Ostrowski

    I have an idea on how to render this very limited macro obsolete!

    Mediawiki have developed some very robust table syntax that let you specify all of the nesting, borders, padding, and alignment that you want without trying to throw around non-differentiable opening/closing tags. No macros! It's built right into the syntax.

    Better yet, Mediawiki will happily let you replicate this functionality in Confluence! There's no need for Atlassian to re-invent the table here. I think it would be a waste of your development resources to keep attempting to solve this problem in such kludgy ways when such an elegant solution is freely available.

    Perhaps after a good solution to tables has been come up with (that is, after you absorb the wonderful Mediawiki syntax), the {section} macro can be remade into a css-based (div-based) layout-creation tool. Tables-for-layout are generally frowned on these days, donchaknow?

    24 Sep 2010
  8. User avatar


    Can any one please tell me how to merge two columns in macro.....

    26 Sep 2011
  9. User avatar


    Using Confluence 4.1, I have a simple page with a section which includes a column which includes a bullet list of page references. I would like to be able to move the list outside of the section/column into another page. Copy/paste of the list data always include the section/column tags. How do I get rid of them?


    04 Mar 2012
  10. User avatar

    Aaron Wideen

    Is there anyway to change the border of a section to solid instead of the dashed?

    25 Jun 2012
  11. User avatar

    Chris Kent

    I just installed the Atlassian "Layout Macros" plugin and it breaks/conflicts with the Section macro, has anyone seen this?

    Now I've disabled the Layout plugin and all now Confluence reports that Section macro is unknown???

    How can I fix this?

    13 Sep 2013
    1. User avatar

      Chris Kent

      An Update for all: there was nothing wrong with the section macro - sorry.  After debugging, it was User Macros from another source inside the sections which were causing us problems.

      26 Sep 2013
  12. User avatar


    Also found issues with the Section macro - have used it happily without problems until about a week ago when pages with two sections one above the other stopped rendering and wouldn't load. Through trial and error I found that removing the second section solved the problem. Don't know if this coincided with a 'Layout Macros' update? I have version 2.1.5 here....

    26 Sep 2013
    1. User avatar


      Hmmmm our fault too. On closer inspection we have Section Macros which don't contain Column Macros. Some simpler pages still render without problems, but others have stopped. We're fixing the pages concerned and all is working.

      27 Sep 2013
  13. User avatar

    Karie Kelly

    Our section macro stopped working (there was no upgrade/update, etc.).  I cannot figure out which plugin that this is associated with our how to troubleshoot (e.g. what can I try to uninstall and reinstall to see if it resolves).  Which system plugin is this macro associated with it as I could not locate it in the documentation or the plugin manager?

    15 Jan 2014
  14. User avatar

    Jens Kasperek

    We do have performance & stability issues on a large enterprise instance (280.000 pages, 138.000 users) with the section macro.
    If users use the section macro only without a column macro, pages will not load within an appropriate time and more fatal, we can even freeze our system.

    On our systems, there were two pages where users only used section macro, without a column inside. After saving the page, they tried to access the pages multiple times because it was not loading in a proper response time (0-5 seconds). So, they just created a bunch of requests which caused our 800% cpu usage on our 10 core machine and multiple database connections for over 15 minutes!

    This is an absolutely critical bug that has to be fixed as soon as possible! Additionally, users should not be able to insert section macro without any column macro! I also reported this issue here: CONF-35285 - Slowness Rendering a Page with the 'Section' Macro Open

    13 Apr 2015
    1. User avatar

      Giles Brunning [Atlassian Technical Writer]

      Hi Jens,

      It's good you've commented on the issue you mention, but I'd also advise that you contact support so they can take a look. They may be able to help troubleshoot or suggest other options to keep things running smoothly.

      14 Apr 2015
Powered by Confluence and Scroll Viewport