Numbering App for Confluence

Stable, referenceable IDs for Confluence documents

Assign permanent, unique identifiers to any content item in Confluence. IDs never shift. References never break. Navigate directly to any item — inside the document.

Permanent content IDs — not available natively in Confluence

Confluence has no native way to assign permanent, unique identifiers directly inside documents. As pages evolve, content becomes harder to track, reference, and verify — causing three specific problems.

01

Numbers shift — IDs are not stable

Confluence heading and list numbers change automatically when content is added or deleted. Item 3.2 today becomes 4.2 tomorrow. Any reference to it — in a ticket, email, or another page — now points to the wrong thing.

02

Cross-referencing specific content is manual and hard to scale

Confluence supports anchors and heading links — so linking to a specific location is possible. To create reference in current page it requires switching to the target page, editing it, finding the location, adding and naming an anchor, copying the URL, save target page and returning to paste it. Across dozens of items this becomes slow, fragile, and hard to maintain.

03

No lightweight overview report

Confluence Table of Contents provides a structured overview of page headings, but there is no native way to list, filter, or sort custom IDs or numbered items on a page. Jira can report issues through filters and queries, but cannot generate a report of items referenced within a specific Confluence page.

With Numbering App for Confluence

Stable IDs — assigned once, never change

IDs survive page edits, content moves, and saves. REQ-12 always means REQ-12.

Jump to exact item position — scroll + highlight

A built-in reference macro lets you navigates directly to the ID on referenced page, scrolls to it, and highlights it with a confirmation flag.

Instant report inside Confluence

A built-in report macro lists all ID on any page — filterable, sortable, searchable — without leaving Confluence.

Works entirely within Confluence

Any editor can define new prefixes and numbering schemes directly on a page — no Jira projects to create correct prefixes, no admin to contact, no waiting. REQ, TC, RISK, API, TASK — all on one page, set up in seconds.

Three macros - complete traceability

Numbering App macro relationship diagram Three Confluence pages showing Num Link on page Y referencing a Num ID on page X, while Num Report on page Z lists all Num IDs from page X Page Y Num Link → REQ-2 / page X Referencing page Page X — source REQ-1 System login via SSO REQ-2 Session timeout 30m REQ-3 Password reset flow Source page Page Z Num Report — page X REQ-1 REQ-2 REQ-3 Reporting page Num Link (Page Y) references a specific ID (Num ID macro) on Page X • Num Report (Page Z) lists all IDs from Page X
Macro 01

Num ID

The core macro. Placed inline on a Confluence page to mark any content / item with a permanent, unique identifier.

  • Choose a prefix (REQ, TC, SEC, SOP…) from configured prefixes
  • Configure your own prefixes directly in macro
  • Define your own start number and increment for prefixes
  • System auto-assigns the next sequential number — no duplicates
  • ID is stable — survives page edits, moves, and saves
Macro 02

Num Link

A reference macro that creates a live, navigable link to any Num ID — on the same page or a different one.

  • Select any existing Num ID from a Num Link macro picker
  • Reference is displayed as a clickable link with the target ID and custom title
  • Works across different pages within the Confluence
  • Navigates to the exact ID position — scrolls and highlights with a confirmation flag
  • When target ID is removed or reconfigured Num Link macro shows "broken link" notification
Macro 03

Num Report

A reporting macro displaying a structured, interactive list of all Num IDs on any specified page.

  • Report IDs from any page — current or any other
  • Filter by prefix or by selecting specific IDs
  • Sort IDs by page order, ascending, or descending
  • Free-text search across IDs and titles
  • Collapse report data to save space on page

What Numbering App adds to Confluence

Feature Confluence Jira issues in Confluence Numbering App for Confluence
Stable ID May shift Permanent Permanent
Custom prefix (REQ, TC, SEC…) Numbers only Requires Jira project Per page
Multiple prefixes on one page Not native Requires Jira projects Native support
Link to exact ID/item across pages Manual anchor setup Opens Jira, not page Easy link + exact landing
Broken reference notification Not native Not native Flagged in macro
List all IDs on a page Headings only Not page-native Instant — Num Report
Ready to use immediately Any editor Admin required Any editor
Comparison based on native Confluence Cloud and Jira Cloud features as of April 2026.
Native support
Requires setup
Not native

Expand beyond requirements

Any team that needs stable, referenceable identifiers inside Confluence documents — not just business analysis teams.

Business Analysis

Requirements tracking

Stable REQ IDs that survive the entire project lifecycle — from inception through testing and sign-off.

QA & Testing

Test case documentation

Write detailed test cases directly in Confluence — each marked with a stable TC ID.

Systems Architecture

API & interface definitions

Label API endpoints, interface contracts, and technical design decisions with stable identifiers for unambiguous technical blueprints.

Legal & Compliance

Contract & audit documentation

Clause and audit checkpoint numbering that stays stable during multi-party negotiations and regulatory reviews.

Operations

Standard Operating Procedures

Assign permanent reference numbers to SOPs so teams can cite exactly which procedure version was followed.

Risk Management

Risk & issue registers

Track risks with stable RISK IDs across project phases — reference them in decisions, mitigations, and reports.

Forge-native

Built on Atlassian Forge. Your data never leaves Atlassian Cloud.

"Runs on Atlassian" eligible

Inherits Atlassian's security, compliance and data residency standards.

Built by practitioners

Designed by analysts and architects who have lived this problem on real enterprise projects.