Can I automatically find and delete unused (orphaned) attachments?


I have wiki pages where a lot of images are still attached to the page but are not included in the page anymore (because they were replaced or updated).

I was wondering if there is a way to erase this outdated images automatically. So far I do it all manually by making a copy of the wiki code, search for missing images and then reinclude them.


5 answers

1 accepted

Hi Steffen,

There are scripts written for this. Please refer to this page for more information. If it worked correctly it will flush the missing attachment.

Hope it helps


Thanks Josua.

But I am afraid this is not for me. I am just a normal user and I can't access the server's installation or run SQL commands. I was hoping to find a "frontend solutions" where things like that are not necessary.

Can I count that out? (Knowing this wouldn't be that bad and at least I knew that I could stop searching.)

Hi Steffen,

Sorry for the delay in responding to you! There's currently no way to do this through the front end, but a feature request has been created here:

At Atlassian we allow our customers to input into our bug fix and feature request prioritisation. We do this with the voting system - the more votes and detailed comments a ticket has, the more likely it is to be implemented. We use this as a way of gauging the needs of our customer base as a whole. I'd recommend voting on that ticket, and adding a comment detailing how it affects your system and what you would like to see. If you also add yourself as a watcher to the ticket, you'll be notified whenever it's updated.


PS. I actually just found some scripts which might help, so I'll post that as a separate answer.

Archiving Plugin automatically tracks unused pages, and this mechanism could be easily extended to track unused attachments, as well. (The tracking code does not actually depend on the content type at all.)

There is a public feature request for this. Please vote for this and when it gains enough interest, we will make sure to implement it:


We came across the same need to be able to easily identify all unused attachments in a Confluence instance and decided to create a plugin for it.

You can find it here:

Let us know if it helps.

AlutusTech Team

The links provided here help me a lot, thanks! 

Many of our users not working much with Confluence assume that deleting an attachment link, file viewer etc. on the page / blog post will also delete the attachment. Some also forget about this. They take the attachment off the page and forget about it being physically still there. I guess this is the reason why we have quite a mess here, too. The fact, that attachments do not always have to be linked or embedded in order to be displayed makes it not easier (I think about macros like attachments / attachment table etc.) 

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

276 views 2 10
Read article

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