After upgrading Confluence HTML macro does not work

Hi there,

We have found following when upgrading Confluence from 3.5 to 4.2.

HTML macro is shown as "unknown macro" on Confluence pages. We realized that "legacy" html macro was enabled and "xhtml" html macro was disabled by the system.

Use HTML code within a Confluence page (Legacy)

Use HTML code within a Confluence page

Can you let us know the difference of these two ?


Daisuke Niwa

1 answer

1 accepted

There are 2 HTML plugins. One is bundled with Confluence and can be found in the System plugins section as the Confluence HTML Macros plugin. Most of the macros are disabled by default as they are not secure if your site has untrusted users. If this is the one you want to use, then enable the html-xhtml macro. That is the one that works in the new editor. The legacy one is for use with Insert wiki markup.

The second plugin is the HTML Plugin for Confluence which also has an html macro (both xhtml and legacy) - however, these macro can be secured with Macro Security for Confluence. You must disable the system html macros in order to use the macros from this plugin. If you had this installed on your Confluence 3.5 system, then you will want to upgrade to the latest version and note the instructions on the documentation page: HTML Macro

Hello Bob,

Thank you a lot for your quick and detailed response.


Daisuke Niwa

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Feb 06, 2019 in Confluence

Try out the new editing experience

Hi team, I’m Avinoam, a product manager on Confluence Cloud, and today I’m really excited to let the Community know that all customers can now try out the new editing experience and see some of the ...

911 views 45 7
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you