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

This widget could not be displayed.

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 Monday in Confluence

Why start from scratch? Introducing four new templates for Confluence Cloud

Hi my Community friends!  For those who don't know me, I'm a product marketer on the Confluence Cloud team - nice to meet you! For those of you who do, you know that I've been all up in your Co...

288 views 2 4
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