Unable to Download Attachments after Direct File System Manipulation

Platform Notice: Cloud and Data Center - This article applies equally to both cloud and data center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Symptoms

After copying attachment files into the correct location on disk (using the schema in the Hierarchical File System Attachment Storage), the attachment is invalid after download.

Cause

The file size is recorded on the ATTACHMENTS table in the database, not from the file size on the file system. When downloading, it retrieves a partial download, equivalent to the byte size from the database record.

Resolution

Do not upload different attachments in place of existing ones. See How to add multiple attachments to a page at once for tips on how to bulk upload attachments.

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.