Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Numbered Headings in Confluence: 3 kinds of solutions

Headings are vital for giving your Confluence page structure, but having too many headings can make your content difficult to follow.

That’s where numbered headings come in. Numbered headings help you to organise the right information into sections, improving the accessibility and navigation of your Confluence pages. 

Though you can’t automatically number headings using built-in Confluence tools, there are other solutions. We’ve covered three approaches — and why each might be right for you.

Reading list-rafiki.png


1. Number your Confluence headings manually

While you can manually number headings in Confluence, it can take a lot of time and energy. This is your primary option if you don’t want to improve Confluence’s functionality with a macro from the Atlassian Marketplace.

How to do it

We refer to main headings as top-level headings in this article. Any headings below these are called subheadings.

  1. Navigate to your Confluence page. In the toolbar, click the edit button (the pencil icon).

  2. Find your first top-level heading. Right before the heading name, type your first number and a period, followed by a space.

  3. If you have subheadings in this section, number them following the numbered headings format. 
  4. Do this for each section in your Confluence page, with every top-level heading beginning with a new number.
  5. Click Publish to save your changes. Admire your new numbered headings.





The real drawback of this method is that it’s fiddly and time-consuming. If you have lots of headings, it’s also easy to miss the correct order of them, meaning you might have to backtrack on your progress.

The problem with the numbered headings being manual is that they don’t automatically update when your page changes. If sections get reordered or removed, your headings could end up numbered incorrectly, meaning the manual approach could be the wrong choice if you’re collaborating with others on Confluence pages.

Manually numbering headings could be suitable for you if… 

  • You don’t have many Confluence pages to edit
  • You have few headings/subheadings
  • You aren’t collaborating on Confluence pages
  • Your content is static, and you’re unlikely to update it

If you are collaborating or working with more complex pages, keep reading for a better alternative.


2. Auto-numbered headings using macros for Confluence

If you don’t have the time to keep on top of manually numbered headings, some handy Confluence macros on the Atlassian Marketplace will take care of that for you.

unnamed (1).gif

2.1. Numbered Headings macro apps 

Numbered Headings apps are ideal if you want a simple but effective tool that takes the hard work out of numbering your headings. You can find a list of such apps in Atlassian Marketplace.

One of such app is Numbered Headings. It gives you access to this simple (but powerful) macro from an easy-access button in your toolbar, so you don't need to add any extra macros to the content.

This app has different heading formats, such as Roman and Latin, to suit varied page needs. And here are some of its main features:

  • Numbers headings at the click of a button - no other macros needed
  • Different numbering formats to tailor your page structure
  • Quick and easy to update headings when sections change or are removed 

However, one of such solutions might not be the best choice if you need more features or functionality. If you plan to invest in extra macros to improve the structure and style of your Confluence pages.


2.2. All-in-one styling: apps with a collection of macros

To save your team's time and money on installing different add-ons for different macros, you can look at more comprehensive solutions that will equip your team with a wide range of the most necessary macros for content formatting. One of such app is Content Formatting Macros for Confluence. It is a collection of macros that can boost your pages' overall structure and look, including Numbered Headings.

How does it differ from the standalone Numbered Headings macro?

The Numbered Headings macro is just one of the many helpful tools included in the Content Formatting Macros suite. Numbered Headings functions similarly to the standalone version with an easy-to-use button in the toolbar.

Content Formatting Macros provide a wide range of features that can make your pages more interactive and user-friendly. This includes various of

  • macros that allow you to organise your pagestabs, progress bar, numbered headings)
  • visual macros: button, background, cards
  • give users extra context: tooltip, LaTeX, etc

Screenshot 2023-03-30 at 12.03.17.png

Screenshot 2023-03-30 at 12.02.34.png

Whether you’re improving your documentation’s structure or making a knowledge base more visually appealing, you can use Numbered Headings with the other macros to make your Confluence pages even better.

Apps with a collection of macros could be right for you if… 

  • You want your content to include your company branding
  • You’d like to make your Confluence pages more accessible and interactive
  • You want to save money by investing in a bundle instead of many standalone macros 

Note: These macros are compatible with Confluence for Cloud. Server/Data Center Users, don’t worry! You can set up auto numbered headings using the CSS Stylesheet in Content Formatting Macros for Server/DC - learn how with this guide


If you’re unsure which approach best suits your needs, remember that you can try every solution and choose which one is better for you. Most of the apps from Atlassian Marketplace allow you to set up a trial version for free. You can enjoy 30 days of unrestricted access to all the included macros, helping you decide whether you’ll benefit from the features beyond Numbered Headings.





Log in or Sign up to comment
Marketplace Partner
Marketplace Partners provide apps and integrations available on the Atlassian Marketplace that extend the power of Atlassian products.
October 3, 2023

Zoriana notes some good options in the article. I will add these other apps available on the marketplace:

Numbered Headings by Easy Apps (cloud)

Auto Numbered Headings (data center)

Easy Numbered Headings (cloud and data center)

Numbered Headings (cloud and data center)

Like # people like this
David Liechti October 13, 2023

Yea how about you just offer this very basic feature right out-of-the box.... pathetic.

Like # people like this
Marketplace Partner
Marketplace Partners provide apps and integrations available on the Atlassian Marketplace that extend the power of Atlassian products.
October 18, 2023

@David LiechtiI hear you. Even beyond cost you need to then manage a lot of apps.

We built a suite of tools in one app called Space Content Manager. Admins can restrict to select users/groups or turn off any feature.

As of Oct '23 we haven't added numbered headings to it yet. But you get the point, fewer apps and more value for money.

Oshadhi Vindhyani December 29, 2023

Oh, this is the solution I was looking for. Thank you so much for this. I'm not the site admin but I asked my site admin to install the app because we need confluence for collaborative documentation and this app will put my team members at ease.  

Michael Aglas January 4, 2024

We could do it ourselves, if only we would be able to use user macros also in Cloud...

Like # people like this
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
January 15, 2024

Ridiculous you dont have this functionality included in the product.

Like # people like this
Vasanthi Ramasamy February 20, 2024

Content Formatting Macros for Confluence I am looking at the price and it is absolutely ridiculous.  My needs are very simple - numbered headings. I am supposed to buy the "content formatting macros" and pay thousands of dollars per year for a simple "numbered heading"? This is ludicrous. 

Like # people like this
Abi Brown February 20, 2024

@Vasanthi Ramasamy we do have this as a standalone app Kolekti numbered headings its is free up to 10 users




Vasanthi Ramasamy February 20, 2024


Vasanthi Ramasamy February 20, 2024

$3000+ per year! This is simply mind blowing. We have to pay to get numbered headings in a document is unbelievable. Confluence has lost the respect I had. I wonder whether it is the right tool at this point. 

Like # people like this
Mitch McKinnon April 15, 2024

Do ALL team members\readers need to have this app in order to have numbering appear in a page they're reading? Or can I use it to add numbering to a page, and that numbering will appear for anyone who reads the page, whether they have this app or not?

Marketplace Partner
Marketplace Partners provide apps and integrations available on the Atlassian Marketplace that extend the power of Atlassian products.
April 15, 2024

@Mitch McKinnon once numbering added to a page using an app it shows for all users including for public pages. It is like any other content once the page is updated.

This is the case for all numbered heading apps.

I would say test a few apps. The differences between them can seem subtle. For example our app, Numbered Headings by Easy Apps, automatically updates whenever you re-publish a page

AUG Leaders

Atlassian Community Events