Unable to select form to migrate attachments from database to file system

Still need help?

The Atlassian Community is here for you.

Ask the community

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


If you're storing attachments in the Confluence database (we deprecated this method in Confluence 5.4), your Confluence site won't start up when you try to upgrade to Confluence 8.8 or later.

To upgrade to Confluence 8.8, you must first migrate your attachments to the file system. The instructions for how to do this are below, along with a workaround if you experience an issue with the checkbox in the user interface.

You must have system admin permissions to configure attachment storage.


Confluence 7.19 or later using database attachment storage (deprecated)


  1. Go to Administration > General Configuration > Attachment Storage
  2. Select Edit to modify the configuration
  3. Within the Attachment storage list of options, select Locally in the Confluence home directory 
    1. If you are unable to perform this action because the checkbox is disabled, right-click in your browser, and select Inspect to open the developer console or developer tools for your browser.
    2. Select the Console tab
    3. Paste this script into the console

      if (window.location.pathname.endsWith('editattachmentstorage.action')) {
          for (let radio of document.querySelectorAll('div.radio')) {
              const input = radio.querySelector('input'), label = radio.querySelector('label');
              if (input && label) {
                  label.setAttribute('for', input.id);

    4. Hit Enter to run the script
    5. Return to the Edit Attachment Storage page where you will now be able to select the Locally in Confluence home directory checkbox
  4. Select Save to save the changes
  5. A screen will appear, asking you to confirm your changes. Select Migrate to start the migration and view its progress

Last modified on Jan 8, 2024

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.