Using Linking to create pages with incremental IDs

Scenario

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

Using the Child Counter Supplier, you can use the number of children pages as ID.

Check this in action on our demo site!

Result

Recipe

Apps	Linking for Confluence Server

Apps	Linking for Confluence Server
Platform	Server and Data Center
Level	Intermediate
Estimated time	10 minutes
Macros	Add Page
Suppliers	Child Counter Supplier

Storage format

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

<h2>Assets</h2>
<hr/>
<p>
  <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>
</p>
<p>
  <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>
  </ac:structured-macro>
</p>

Macro structure

You can recreate the example in the editor view:

Steps

Add an Add Page macro.
Add a title for the Create link text field, e.g., 'Document new Asset.'
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 'Asset #' text at the beginning.
2. They are followed by the number of children on the page (as an ID). Here, we use an 'injection' notation with a 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'.
Add a Children Display macro to display the children pages created by the Add Page macro.
You can alter or reset the counter provided by the Child Counter Supplier. See Child Counter Status for more information.

Line-by-Line Explanation

N/A