Excel-like Tables for Confluence Data Center
Excel-like Tables for Confluence Data Center
Breadcrumbs

Clean Up Corrupted Attachment Versions


Use the Attachment Health Manager (available in v1.2.9.1 and above) to identify and remove corrupted attachment versions while preserving healthy data. You can also use this Health Screen to check the overall app health in your instance.

If your instance has corrupted attachment versions, the Health Screen shows what is affected and how many versions are impacted.

image-20260309-085819.png
How the screen looks with corrupted versions


Cleaned screen

image-20260309-085437.png
How the screen looks without corrupted versions



How to use it (Bulk Delete)

Use bulk deletion when you trust the scan results and want a fast, site-wide cleanup. This is the quickest way to restore normal operation.

  1. Click Delete All Corrupted Versions to start bulk cleanup.

    image-20260309-084736.png

  2. A confirmation dialog appears. Review the count of versions to be deleted.

    image-20260309-084329.png

  3. Click Confirm to proceed. The system deletes only versions flagged as corrupted.

  4. Wait for the success message, then refresh the scan to verify the corrupted count is zero.

    image-20260309-084435.png

Pre-Deletion Requirements & Safety Checks

  • Administrator access required: Only Confluence or System Administrators can access Attachment Health Manager and perform deletions.

  • Backup first: Download the latest healthy version of each affected attachment before deleting corrupted ones.

  • Change window: Perform cleanup during low-usage periods with proper approval to minimize impact.

Best practice: Back up the current attachment before removing any version. If you delete a wrong version, restore it immediately from backup.

Targeted cleanup is recommended if you want to validate each case, preserve specific intermediate versions, or when certain attachments require special handling.

Verification After Cleanup

  1. Reload affected Confluence pages containing Excel-like Tables and confirm the tables render normally without errors or endless loading.

  2. Open the Excel-like Table history (if applicable) and confirm recent changes exist up to the latest healthy version.

  3. Re-run or refresh the Attachment Health Manager scan to ensure the corrupted versions count has dropped to zero.

Tips and Troubleshooting

  • Start with bulk delete when widespread corruption is indicated. It’s safe: only flagged versions are removed.

  • Prefer per-attachment review for critical pages where you must keep specific intermediate revisions.

  • If tables still fail to load after cleanup, check for remaining corrupted versions on related attachments (e.g., multiple table data files per page).

FAQs

Does deleting corrupted versions remove my entire spreadsheet?

No. Only the flagged corrupted versions are removed. Healthy versions remain, and the attachment itself stays available.

Should I bulk delete or handle attachments individually?

Use bulk delete when the scan accurately marks all corrupted versions and speed is important. Use individual review for sensitive pages where you need granular control.

How do I confirm the cleanup worked?

Reload affected pages to ensure tables render, and refresh the Attachment Health Manager to verify corrupted counts are zero. Keep your backups until you confirm stability.