Skip to main content
Skip table of contents

How to use Numbered Headings for Confluence

Enable Numbered Headings on any page

On any page in the menu bar click on Numbered Heading:

You will get a popup. Click to enable:

This opens configuration:

Choose numbering format

The drop-down has all the common numbering formats. Choose one:

If you want a dot after each numbering check this box. By default it is not checked. This is a popular feature:

Optional: custom formatting

If you want to ‘mix and match’ formatting options per section then click on Use custom format. Example: top level can be Decimal, but the rest can be Roman - lowercase.

This opens custom formatting:

Choose a formatting option for each section:

Optional: skip headings

The default is By level.

Select the H1 to H6 headings not to number. The ones you select will always stay the same as the original text, meaning they will be ignored by Numbered Headings:

By search terms is used to not numbering heading that contain specific terms.

It works as a 'contains'. Example if you enter “New” and the header is “All new projects” it will be skipped because it contains the term “new”.

By default terms are not case sensitive. Check the box Case sensitive to make the terms case sensitive.


You get a preview of the numbering structure before you click Apply. In this example Roman - lowercase with a dot after were selected. It works no matter how customized your numbering formatting.

Note: it does not include the actual text from the page headings, it uses placeholder text. The goal is to show you the numbering structure so that you can apply with confidence.

Confirm changes

Reload page (required)

After clicking Apply you must reload the page.

Example of a result

The first time you apply numbered headings to a page (or anytime you manually open the pop-up, change settings and re-apply) the page change is attributed to the user (no logo).Later, when you or anyone else updates the page and the numbering is automatically updated, then you'll see the logo (since that change is done by the app in the background).Can you confirm I have the correct logo?

Important: you must reload the page after clicking Apply

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.