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 Oct 24, 2018 in Confluence

Atlassian Research opportunity with Confluence templates

Do you use templates with Confluence? Take part in a remote 1-hr workshop. You'll receive USD $100 for your time!   We're looking for people to participate in a   remote 1-hr workshop...

990 views 14 12
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