Documentation for Confluence 5.8 (Server).
Documentation for Confluence Cloud and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

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 nameRequiredDefaultParameter description and accepted values


NoFalseIf 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

  • No labels


  1. Anonymous

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

    1. 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.


  2. 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.



    1. 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.


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

    Standard Section, no border

















    1. 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

  4. 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">

  5. Anonymous

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

    1. Hi,

      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.


  6. Anonymous

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

  7. 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?

  8. Anonymous

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

  9. Anonymous

    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?


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

  11. 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?

    1. 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.

  12. 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....

    1. 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.

  13. 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?

  14. 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

    1. 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.