Resolve missing attachments when migrating to cloud via Confluence Cloud Migration Assistant
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server 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
Summary
The Confluence Cloud Migration assistant helps you move content, users, and groups from Confluence Server to Confluence cloud. When migrating confluence spaces via the migration assistant, sometimes attachments are found missing from spaces in the destination cloud site.
This can happen if the attachment files are deleted, renamed, moved to another folder, or the attachment directory doesn’t have read permissions. It may also be that there was an error in removing the record of the attachment from Confluence. You can view details of the missing attachments at the Pre-migration checks stage by downloading the CSV file given along with the check for missing attachments.
In this article, we will focus on workarounds to tackle the missing attachments issue.
Resolution
To fix the issue before the migrating to cloud, proceed with the following steps:
Navigate to Attachment storage. You will find the path to the attachment directory under Filesystem.
Ensure that this directory has execute permissions, which means that the users with appropriate permissions can access the files within the directory.
From the Pre-migration checks page, download the CSV file to view details of the missing attachments.
Open this CSV file to access the File path for the missing attachment.
If the attachment is missing, upload a new file with the same name in place of the missing attachment at the same file path. Please ensure this file has the required read permissions.
Refresh the missing attachment on check on the Pre-migration checks page to resume the migration.
It is recommended that you fix the issue when it is first detected in the Confluence Cloud Migration Assistant. If you discover missing attachments after you have already migrated to Cloud, contact support to resolve this.