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

This widget could not be displayed.

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.

This widget could not be displayed.

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

403 views 4 6
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