You're on your way to the next level! Join the Kudos program to earn points and save your progress.
Level 1: Seed
25 / 150 points
1 badge earned
Challenges come and go, but your rewards stay with you. Do more to earn more!
What goes around comes around! Share the love by gifting kudos to your peers.
Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!
Join now to unlock these features and more
The Atlassian Community can help you and your team get more value out of Atlassian products and practices.
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.
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.
We refer to main headings as top-level headings in this article. Any headings below these are called subheadings.
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.
If you are collaborating or working with more complex pages, keep reading for a better alternative.
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.
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:
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.
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
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…
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.
Product Marketing Manager
2 accepted answers