Linking can add identifier to your page titles. With this, you can name your catalogue pages or series of assets, projects, components, ideas or configuration pages with an ID as prefix or postfix.

By using the Child Counter Supplier, you can make use of the number of children pages as ID.

Check this in action in our demo site!




Linking for Confluence Server


Server and Data Center



Estimated time

10 minutes


Add Page


Child Counter Supplier

Storage format

You can copy and paste this code into the Confluence Source Editor:

  <ac:structured-macro ac:macro-id="77455a8b-7630-4234-a312-4cbb39c4e516" ac:name="children" ac:schema-version="2">
    <ac:parameter ac:name="sort">title</ac:parameter>
  <ac:structured-macro ac:macro-id="45601cb2-e628-4967-8e21-941f97cdeff8" ac:name="add-page" ac:schema-version="1">
    <ac:parameter ac:name="prefix">Asset #%child-counter:next &gt; number:000% - </ac:parameter>
    <ac:parameter ac:name="linkText">Document new Asset</ac:parameter>

Macro structure

You can recreate the example in the editor view:


  1. Add an Add Page macro.

  2. Add a title for the Create link text field, e.g. 'Document new Asset'.

  3. Since we want to automatically add an ID at the beginning of the pages (created by the link), fill out the Prefix parameter:

    Asset #%child-counter:next > number:000% - 

    What this means:

    1. Every page title will have the text 'Asset #' at the beginning.

    2. Followed by the number of children page (as an ID). Here we use an 'injection' notation with key from the Child Counter Supplier. The notation 'number:000' defines the format of the number e.g. '001', '002', and so on.

    3. When clicked, users will be prompted to complete the title of the page e.g. 'Asset #054 - Laptop'.

  4. Add a Children Display macro to display the children pages created by the Add Page macro.

  5. You can alter or reset the counter provided by the Child Counter Supplier. See Child Counter Status for more information.

Line-by-Line Explanation