Numbered Headings macro

The Numbered Headings macro allows you to number parts of a page. You can have multiple macros on a page in their own numbering format.

Using the macro

You can find the Numbered Headings macro in the Confluence macro browser. When you edit a page, locate the Insert button in the editor toolbar and choose Other macros. In the browser, search for Numbered Headings. Alternatively, you can start typing on the page. By typing /number, Confluence suggests adding the Numbered Headings macro. Place any content containing headings you wish to number inside the macro.

Headings are not numbered while you are editing the page. When you view a page, the macro automatically numbers the headings of its content.

Numbered Headings Macro - Before Publishing the Page
Numbered Headings Macro before publishing the page
image-20240324-152346.png
Numbered Headings Macro after publishing the page

You can add multiple macros to a page, but the macros are not connected to each other.

Configuration

You can change the configuration of the numbering if you do not want to use the default numbering format. Click the macro to see the option to edit the macro, and select Edit to open the macro editor.

You can perform the following configurations in the editor:

  1. Number format: Choose a number format from the dropdown.

  2. Starting numbers: Add a comma-separated list to change the starting numbers of several levels of headings.

  3. Starting heading: Choose the heading from which you want the numbering to begin.

  4. Skip headings: Skip the heading that you don't require to number.

  5. Click Insert once the configurations are set as required.

For a detailed overview of the available formatting options, refer to Formatting options.

Content preview

If headings are present in the macro content, you can preview the current settings on those headings using the Show own headings toggle.