You can use Counters for Confluence to define numbered headings in your Confluence pages and automatically count them. Therefore we developed different macros to easily control and define the counters.

See the Examples Page for further details and examples of the usage.

Existing Macros

There are three different macros to use Counters for Confluence:

Counter NameEnterDescription
Counter{counterThis macro should be used if you just want to insert a classic counter.
Named Counter{named counterThis macro should be used if you want to have different counters on the same Confluence page.
Setup Counter{setup counterThis macro should be used to reset and define a counter.

Counter

This macro prints an automatically countered number. The only setting you can make is defining the level you want to count. If you leave the field empty, 1 is used as default level.

Named Counter

This macro is to name different counters. This is useful, if you have multiple counters on the same Confluence page with different formats.

ParameterDescription
Counter Name
The name used to identify the counter.
(info) This field is obligatory.
Level
Enter the level to print.
(info) Defaults to 1 if empty.

Setup Counter

This macro is to define the counters. You can format the counter and named-counter macros with formatting and can reset a counter to a custom value. Check the following table for an explanation of the several settings:

ParameterDescription
Counter NameThe name of the counter to configure. Leave empty to configure the default (unnamed) counter.
Reset Level
The counter level to reset.
(info) Leave empty for no reset, but either none or both of reset level and reset value must be specified.
Reset Value
The value to reset the counter to, e.g. "1".
(info) Leave empty for no reset, but either none or both of reset level and reset value must be specified.
Numbering Format

You can define the numbering format of your counter:

  • "1" = decimal numbering

  • "a" / "A" lower / upper case alpha numbering

  • "i" / "I" lower / upper case Roman numbering

The pattern is expanded automatically for headings nested more deeply.

Examples:

  • "1" formats every level with numbers
  • "1Ai" formats h1/h4 with decimal numbers, h2/h5 with upper case alpha letters, h3/h6 with lower case Roman numbers.

Print in PDFActivate this checkbox to print the counters in the exported PDFs.