Cannot edit a page with HTML Macro

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Problem

Can't edit pages that contain HTML Macro and JavaScript in Confluence.

Cause

JavaScript code in the HTML Macro is the the root cause of this issue.

Workaround

In order to edit the page JavaScript code needs to be remove from HTML Macro and since it's not possible to edit a page through the Editor we can use either of following resolution:

First Workaround:

  1. Open Confluence HTML Macros from Confluence Admin > Manage Add-ons > All Add-ons

  2. Expand this macro.

  3. Disable both html (html) and html (html-xhtml) modules.

  4. Refresh your page (Open your page in new tab and refresh it there).

  5. You will see unknown macro: 'html'.

  6. Go back to Manage add-ons tab and enable both modules again.

  7. Go back to the page and click on edit.

  8. Remove the faulty script and save the page.

Second Workaround:

  1. Get a copy from your page storage format

    (Auto-migrated image: description temporarily unavailable)

    > Storage Format.

  2. Disable Confluence HTML Macros.

  3. Edit the page.

  4. Remove the HTML Macro with faulty scripts form the page.

  5. Save the page.

  6. Since you have got other codes in that HTML macro as well, you can use your storage format's backup to add them back to the page.

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.