Repair the Confluence Cloud pages your migration quietly broke, one space at a time

To fix broken Confluence Cloud pages after a migration, follow these steps one at a time. Begin by granting yourself space admin rights, as site admin does not include this permission. Use the Node.js script grant-space-admin to add your API token user as an administrator on each space. Verify the dry run output before applying changes.

Next, before trusting any discovery queries, dump the raw storage XML of a few matching pages from your tenant. Storage format varies by app version, so this step ensures you are working with the correct format. Run the sync_html_macros.js script with the --space and --limit options to produce a reviewable plan file.

Read the generated plan file carefully. It lists affected pages and allows you to verify what needs to be repaired. Once you are confident in the plan, execute the fix by running the script without the --plan-only flag. The tool will process each page, repairing broken HTML macros and resolving identity parameters that still hold DC usernames.

After the migration, check the rendered page to verify the fix. This is the only check that can honestly fail, ensuring the pages work as intended. By following these steps one space at a time, you can safely repair Confluence Cloud pages without disrupting your entire site.