nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Is it possible to add numbering to headings in Confluence?

Mick Davidson

Morning,

In Confluence we have headings and we have numbered lists.

Is it possible to combine the two (and then use them as part of a template)?

And to have the numbering working automatically?

The idea is that this would work as it does in Word. So once you start using numbered headings, all subsequent headings get numbered both automatically and down a level each time. For example:

Heading 1 = 1. A Heading

Heading 2 = 2.1 Help

Heading 2 = 2.2 I Need

Heading 2 = 2.3 Your Help

Etc, etc, so everytime a new heading level was added, the numbering also changed to accommodate that.

Does this make sense?

Cheers.

Accepted answers

Amalia

There's a third-party plugin for that: https://marketplace.atlassian.com/16063

All comments

Amalia

There's a third-party plugin for that: https://marketplace.atlassian.com/16063

Mick Davidson

Amalia, thanks for pointing me in the right direction.

Dmitry Pashkevich

Related feature request: https://jira.atlassian.com/browse/CONF-1732

Dmitry Pashkevich

But it's not available for OnDemand instances

Dmitry Pashkevich

Here's the OnDemand version of the plugin (I can't edit Amalia's answer)

https://marketplace.atlassian.com/plugins/nl.avisi.confluence.plugins.numberedheadings-connect

Currently it has some issues but I hope they get resolved in near future

Gert-Jan van de Streek

The add-on now has a stable OnDemand counterpart, you can find it here.

Gert-Jan van de Streek

Since then both the add-on and the OnDemand platform have seen vast improvements. Check our issue tracker for the current status: http://addons.avisi.com/confluence/numbered-headings/issues.html

Precision Plugins

Engineering Essentials has just been released to the public.

This resolves the issue of numbered headings space-wide, without needing to put your content inside a macro.

With Engineering Essentials it is now possible to configure an entire space to have numbered headings. Any enabled space will instantly have it's headings numbered. No additional editing of a page is required. This enforces a consistent look and feel within each space. Additionally, because your content does not need to be wrapped in a macro it does not interfere with page differences, change emails, exports, or other plugins. Ensuring your content will continue to be available into the future, regardless of what plugins you have installed. This simplifies export templates and improves compatibility by defining the correct layout for the particular format within your own templates.

As numbered headings are often required for formal documentation we've also provided the ability to separately force version comments on all changes within a space. Enabling fully automatic change history documentation.

With years of experience supporting Confluence in an engineering environment, Precision Plugins have big plans to plug some small gaps, helping Confluence and other extensions be the best environment for your formal documentation.

Checkout the Engineering Essentials package and let us know what you think here:
https://marketplace.atlassian.com/plugins/com.precisionplugins.engineeringessentials

Maarten Arts

We've recently updated our add-ons website. Anyone looking for help on Numbered Headings can find it here: http://addons.avisi.com/numbered-headings/help/

Vijay Patil

Hi All,

It seems like a very very long pending issue with Confluence.

I found something that sort of works

http://philarcher.org/diary/2011/numbering/

The script works really really well, except the headings start at 3 and everything (even things in the sidebar) get numbered. It will be awesome if someone can figure out how to get this working. I know that there are free plugins, but they clutter up the document and remove the clarity. If we get this working, we can simply put this into <head> and then bingo, everything is right the way it should be.

window.onload = function () {
  var elements=document.getElementsByTagName('*');
  var numbers=[0,0,0,0,0,0,0];
  for (var i in elements) { 
    var e=elements[i];
    if(!e||!e.tagName||!e.tagName.match(/^H([1-6])$/)){continue}
    var eLevel=RegExp.$1;
    var txt='';
    numbers[eLevel]++;
    for(var l=1;l&lt;=6;l++) {
      if(l&lt;=eLevel){
        txt+=numbers[l]+'.'
      } else {
        numbers[l]=0;
      }
    }
    e.textContent=txt+' '+e.textContent.replace(/^[0-9\.\s]+/,'');
  }
}

To try this,

Put the current script in the HTML macro at the end of the page.

I think we need to change this line

var elements=document.getElementsByTagName('*');

The document should be replaced by something that confluence knows as 'page contents'. Please see if you guys can solve this!

markusjenu

I created a script (copied some code from https://stackoverflow.com/questions/5127017/automatic-numbering-of-headings-h1-h6-using-jquery ) you can use in Confluence editor. You can add the script to usermacro and add the macro to header via space tools -> look and feel.

Hotkey hh and a button in the editor.

<script>

 AJS.whenIType('hh').execute(function () { //hotkey
 addIndex();
 });

function addIndex() {
 var indices = [];
 jQuery("#wysiwygTextarea_ifr").contents().find("h1,h2,h3").each(function(i,e) { //.find("h1,h2,h3,h4,h5,h6") if you want all headings numbered
 var hIndex = parseInt(this.nodeName.substring(1)) - 1;
 if (indices.length - 1 > hIndex) {
 indices= indices.slice(0, hIndex + 1 );
 }
 if (indices[hIndex] == undefined) {
 indices[hIndex] = 0;
 }
 indices[hIndex]++;
 if(jQuery(this).text().indexOf(indices.join(".")+" ") <0 ){
 jQuery(this).prepend(indices.join(".")+" ");
 }
 });
}

AJS.toInit(function(){
 AJS.$('#rte-toolbar > div.aui-toolbar2-primary.toolbar-primary').append('<ul class="aui-buttons"><li class="aui-button" id="addIndex">Number headings</li></ul>')
 AJS.$("#addIndex").click(function(e) {
 e.preventDefault();
 addIndex();
 });
});

</script>

lubos tapusik

Hello Markus, just wanted to thank you. Works great!

markusjenu

Few more tweaks:

Removes old heading numbers
1. Removes all numbers from the start of the heading (including dates for example)
does not lose inline comments or inline macros

function addIndex() {
 var indices = [];
 jQuery("#wysiwygTextarea_ifr").contents().find("h1,h2,h3").each(function(i,e) { //.find("h1,h2,h3,h4,h5,h6") if you want all headings numbered
 var hIndex = parseInt(this.nodeName.substring(1)) - 1;
 if (indices.length - 1 > hIndex) {
 indices= indices.slice(0, hIndex + 1 );
 }
 if (indices[hIndex] == undefined) {
 indices[hIndex] = 0;
 }
 indices[hIndex]++;
 var lapset=[];
 jQuery(this).children().each(function(){
 var text = AJS.$(this).prop('outerHTML');
 lapset.push(text);
 });
 jQuery(this).html(indices.join(".")+". " + removeNo(jQuery(this).text()));
 jQuery(this).append(lapset.join(""));

 });
}

function removeIndex(){
 jQuery("#wysiwygTextarea_ifr").contents().find("h1,h2,h3,h4,h5,h6").each(function(i,e) {
 var lapset=[];
 jQuery(this).children().each(function(){
 var text = AJS.$(this).prop('outerHTML');
 lapset.push(text);
 });
 jQuery(this).text(removeNo(jQuery(this).text()));
 jQuery(this).append(lapset.join(""));
 });
}

function removeNo(str) {
 let newstr = str.trim();
 newstr = newstr.replace(/[\u00A0\u1680\u180e\u2000-\u2009\u200a\u200b\u202f\u205f\u3000]/g,' ');
 if(IsNumeric(newstr.substring(0,newstr.indexOf(' ')))){
 return newstr.substring(newstr.indexOf(' ')+1).trim();
 }
 return newstr;
}

function IsNumeric(num) {
 num = num.split('.').join("");
 return (num >=0 || num < 0);
}

lubos tapusik

I noticed it also added some dots to the numbering that weren't there before.

Thanks a lot again.

Btw I call the function removeIndex() right before addIndex(). I hope that's the intended usage.

Florian Proksch

Since all answers here either suggest paid plugins or extensive use of javascript macros I wanted to note that numbering headings can easily be done with a stylesheet (which can be applied globally or space-wide depending on your preferences) using css counters:

#content.page.view {
     /* Set "section" to 0 */
    counter-reset: section;
}

#content.page.view h1 {
     /* Set "subsection" to 0 */
    counter-reset: subsection;
}

#content.page.view h1:before {
    /* Increment "section" by 1 */
    counter-increment: section;
    content: counter(section) " ";
}

/* Continue this scheme as deep as you need */

#content.page.view h2 {
    counter-reset: subsubsection;
}

#content.page.view h2:before {
    /* Increment "subsection" by 1 */
    counter-increment: subsection;
    content: counter(section) "." counter(subsection) " ";
} 

#content.page.view h3:before {
    counter-increment: subsubsection;
    content: counter(section) "." counter(subsection) "." counter(subsubsection) " ";
}

Andy Ackermann

Hi, this doesn't work for me. I want to add section numbering in my PDF report. Where do I have to paste your css?

EEAS

Very nice, thank you

Jian Yao

It works fine for viewing document! But during editing, the numbers are not displayed. Any suggestion for display numbers when edit documents?

Nancy Jaiswal

Hi All,

We have released Auto Numbered Headings plugin https://marketplace.atlassian.com/apps/1219286 which auto numbers the headings of whole space in single click of button. A macro comes along with plugin in case numbering needs to be applied only on selective pages.

Shoham Levy

Here is my little solution, using JQuery in the HTML MACRO.

<script type="text/javascript">

function enumerateHeaders() {
    var i1 = 0;
    var i2 = 0;
    var i3 = 0;

    AJS.$("#main-content :header").each( function(indx) {
        hdr = $(this);
        console.log( indx+": "+hdr.text() );
        switch (hdr.prop("tagName")) {
        case "H1":
            i1++; i2=0 ; i3=0;
            hdr.text( i1+") " + hdr.text() );
            break;
        case "H2":
            i2++; i3=0;
            hdr.text( i1+"."+i2+") " + hdr.text() );
            break;
        case "H3":
            i3++;
            hdr.text( i1+"."+i2+"."+i3+") " + hdr.text() );
            break;
        }
    });
}

AJS.toInit(function(){
    enumerateHeaders();
});

</script>

Arkadiy Birger

I can't believe that such a basic and essential wiki/documentation/knowledge space functionality is still not implemented natively in Confluence, and requires either some hacks with consequences or a 3rd party paid plugin. There is a plugin for everything, it seems, and they all add up in costs, both direct and maintenance. We are starting to get feed up with this approach by Atlassian, and looking at moving away from their products completely.

Kimi

Indeed!

Nancy Jaiswal

Hi Arkadiy and Kim,

I also agree with your point that must to have features should be provided by Atlassian by default. But you also must appreciate that due to this open platform, many features are available at marketplace in form of add-ons. This way at least user can get away with the problem being faced. Wiki/documentation/ knowledge space has so much varied requirements as per use cases that it is very difficult for a close platform to serve all type of needs single handed.

Kimi

Hi Nancy Jaiswal,

Indeed that an open platform like Confluence would let developers create more useful add-ons for end users. I do support this mindset and developers should also make money for their living.

But c'mon, we are in 2019 now, not in the '90s anymore.

Numbering to headings should be a must-have feature instead of an addon. If numbering is not a standard default feature, in my point of view, Confluence should not be called a WIKI system.

Not only that, you cannot even increase text size in Confluence neither, to increase text size you have to use the Macro DIV, correct me If I am wrong.

For IT dummies who are working in a Finance or Marketing department, asking them to use Macro DIV for increasing text size, they would curse the system to death

If you look at Wordpress, Drupal or other open source CMSs, their WYSIWYG editor includes all these features for free. You might ask me why I will not Wordpress or Drupal instead, well, it's a different topic and debate

Cheers

Kim

Christian Sprenger

The link does not work (anymore).

Maarten Arts

@Chri Brunumbering all headings in a whole space is also available on the Server and Data Center version of Numbered Headings. https://marketplace.atlassian.com/apps/16063

Christian Sprenger

Oh, OK, this one I know, but I don't have budget for the plugin.

Anyway, thanks for the new link

andreasgounaris

Nice!

This approach covers TOC as well, where you can include/exclude sections and subsections via regex provided by the TOC macro.

Nick van der Net

It is absolutely ridiculous that in 2021 numbered headings and text size differences aren't supported natively. It's not the 20th century anymore. What's next, Atlassian? Smoke signals.

Poor form....

Christian Sprenger

As all tickets gets automatically resolved in 3 years, I'll sign myself out from these tickets.

Good-Bye Confluence Server

Mike_515zbw

totally agree

David Meyer_2gzvzl

This plugin still not supported in Cloud.
Atlassian has known about this issue for a decade and still makes it another required co$t. I'm not a coder so adding a stylesheet and code as described below isn't really an option.

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

confluence

numbered-heading