Upgrading Confluence Breaks the Display of Macro

Still need help?

The Atlassian Community is here for you.

Ask the community


After upgrading Confluence, inline macros surrounded by a heading have the paragraph (<p>) tag injected into them, which breaks the display of the macro. This is especially true when upgrading from Confluence 3.5.x to 4.x or later.


The migration task that converts wiki markup into the XHTML storage format is not context-aware enough to know when a macro is contained within a heading tag.  


This is a workaround for Confluence 4.3.1


To install the patch:

  1. Stop Confluence
  2. Rename CONF/confluence/WEB-INF/lib/confluence-4.3.1.jar to confluence-4.3.1.jar.backup
  3. Copy the attached confluence-4.3.1.jar to CONF/confluence/WEB-INF/lib/
  4. Start Confluence
  5. Launch the task to migrate incompatible macros, by navigating to <CONF_BASE_URL>/admin/unmigratedwikicontent.action)

Last modified on Feb 19, 2016

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.