Numbered Headings macro on migrated pages retains Connect ADF format, breaking ToC and anchor link navigation

XMLWordPrintable

    • Severity 2 - Major

      Issue Summary

      On pages migrated from Confluence Server/Data Center to Cloud, the Numbered Headings macro retains its original Connect macro ADF format instead of being converted to the current Forge app ADF format. This causes an ID mismatch in the Table of Contents macro code that normally handles Numbered Headings macros, so the ToC macro never properly updates the headings with numberings. As a result, both ToC links and external anchor links (e.g., #PageTitle-HeadingText fragments) fail to navigate to the correct section — instead landing at the top of the page.

      This is distinct from https://jira.atlassian.com/browse/CONFCLOUD-73787, which covers the general incompatibility between ToC and Numbered Headings in the new editor. This bug is specifically about migrated pages where the Connect-to-Forge ADF conversion did not occur, causing localId inconsistencies that break anchor resolution.

      Root Cause :
      Connect macros on migrated pages are not properly converted into Forge apps in the ADF. The Numbered Headings macro's ADF structure still uses the old Connect format, so the ToC macro's code path that matches Numbered Headings macros by their Forge localId values never fires. Headings inside the macro therefore lack the correct anchor IDs.

      Steps to Reproduce

      1. Have a Confluence instance that was migrated from Server/DC to Cloud, where pages existed with both a Table of Contents macro and a Numbered Headings macro prior to migration.
      2. Open a migrated page that contains the Numbered Headings macro with headings inside it (e.g., H2/H3 headings).
      3. On the same page or a parent page, observe the Table of Contents macro.
      4. Click any ToC entry that corresponds to a heading inside the Numbered Headings macro.
      5. Alternatively, navigate to the page using a direct anchor link fragment (e.g., https://site.atlassian.net/wiki/spaces/SPACE/pages/123456/PageTitle#PageTitle-HeadingText).

      Expected Results

      • The ToC link scrolls to the correct heading within the Numbered Headings macro.
      • The anchor link fragment in the URL navigates directly to the targeted section.
      • The Numbered Headings macro applies numbering to headings as expected.

      Actual Results

      • ToC links for headings inside the Numbered Headings macro do not scroll to the correct section — the page stays at or near the top.
      • Direct anchor link fragments (#PageTitle-HeadingText) land at the top of the page instead of the targeted section.
      • The Numbered Headings macro appears disabled and does not apply numbering, because the macro's ADF still uses the old Connect format rather than the Forge format.

      Workaround

      The customer can fix affected pages by:

      • Copying the content inside the Numbered Headings macro.
      • Removing the old Numbered Headings macro.
      • Re-inserting a fresh Numbered Headings macro and pasting the content back in.

      This re-insertion gives the macro a proper Forge ADF format where the localId values are consistent, restoring ToC and anchor link functionality.

       

              Assignee:
              Cathy Li
              Reporter:
              Tanya -
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

                Created:
                Updated: