Hullspark

Attachment Sweep for Confluence

Find large and unused attachments, see how much space they take, check with a dry run, then move them to the Confluence trash. Nothing is purged.

Try it on the Atlassian Marketplace Getting started: your first cleanup in four steps 日本語のページ

Free for up to 10 users; see the Marketplace listing for paid tiers. Runs entirely on Atlassian. For Confluence Cloud administrators.

Attachment Sweep scan result with the total size of unreferenced attachments and a table of files
Scan results: how many attachments no page uses, and the space they take.

In four lines

  1. The problemConfluence is running out of space, but nobody knows which attachments are safe to delete. The only way to find out is to open pages one by one.
  2. Where it is on screenApps, then Attachment Sweep, then the Scan tab. One result line reads N unreferenced (X total). Site administrators only.
  3. What you doRun a scan. Read the reason on each row. Select the unreferenced files, press Dry run, then move them to the trash.
  4. What you getYou know how much space you can free before anything moves. Moved files sit in the space trash, where a space admin can restore them. The Jobs tab keeps a log.
Attachment Sweep demo video thumbnail
Demo video. Nothing loads from YouTube until you press play.

What you can do

See how much space unused files take

One scan ends with one line: how many attachments no page uses, and their total size. The table lists each file with its page and size, biggest first.

Every file shows why it was flagged

Each row says why: unreferenced, referenced by another page, or a cover picture. Only unreferenced files can be selected, so a file that is in use is never picked by mistake.

Scan results with a Reason column
The Reason column on the scan results.

Dry run first: nothing is deleted

Press Dry run to see how many files would move to the trash and their total size. Nothing is written until you confirm.

Dry run result listing the files that would move
Dry run result with the note that nothing was written.

Moved to the trash, never purged

Files go to the Confluence space trash, where a space administrator can restore them. Each file is checked again right before it moves, and skipped if it changed.

Confirmation dialog for moving attachments to the trash
The confirmation dialog before files move to the trash.

See exactly what moved

The Jobs tab shows how many files were done, failed or skipped, with a log you can open.

Jobs tab with a finished move-to-trash job
A finished job in the Jobs tab.

Good to know before you start

  • Trash, not purge. A moved file can be restored only while it is still in the space trash. If someone purges the trash, the file is gone.
  • References from comments, templates and whiteboards are not checked.
  • A scan limited to one space does not see references from other spaces. Run a site-wide scan if in doubt.
  • Attachments newer than the minimum age (7 days by default) are never listed.
  • A scan result older than 24 hours must be re-run before you can delete from it.
  • Scanning and the dry run work without a license. Creating a delete job needs an active license.

Questions

Is “Move to trash” permanent? Can I undo it?

No, it is not permanent. The app uses Confluence’s normal delete, which moves the attachment to the space trash. It never purges. A space administrator can restore it from the trash. Before anything moves you get a dry run, and every job writes a log.

I can’t find the app in the Apps menu.

Attachment Sweep is shown to site administrators only. It also runs with your own permissions, so attachments in spaces you cannot view are never scanned or listed.

An attachment is listed as unreferenced but it is in use.

The scan reads page and blog post bodies, attachment and gallery macros, and page properties such as cover images. A scan limited to one space does not see references from other spaces, so run a site-wide scan if in doubt. If a result is still wrong, email support@hullspark.com with the page URL and file name.

Does my data leave Atlassian?

No. The app runs on Atlassian and your attachments are not sent to Hullspark. Details are in the privacy policy.

What does it cost?

Free for up to 10 users; see the Marketplace listing for paid tiers.

Try it on the Atlassian Marketplace

Guide

Related Hullspark apps for Confluence

Other Hullspark apps

Questions? Support or support@hullspark.com.