How to remove Unknown macro: {XYZ} error in multiple confluence pages

Hi All,

Couple of years back we have deleted few macro's which are used in many pages, We are getting "Unknown macro: {XYZ}" in all the pages how to get rid of these errors. 


Thanks in Advance,


2 answers

Hi Kumar,

the Search and Replace Plugin ( can remove macros globally. 

Just find out the name of the macro (e.g. by looking at the storage format) and remove it using the plugin. IF you need further instructions, feel free to ask.

Best Regards,


I will try using it Thank you

Let me know if it worked.

0 votes

Edit the pages and remove the broken macro entries.

A slightly less clean trick is to define a "user macro" with the same name (i.e. XYZ), then you can control the output - at least make it a bit nicer than the "unknown macro" display.

I will try this too Thank You

I should point out that the "user macro" trick is a cosmetic patch to make things look better. Ideally, remove the broken entries (and Lukas' answer can help you better there)

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 ...

783 views 33 5
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