Using Drag-and-Drop in Confluence

Overview of the Drag-and-Drop Feature

Confluence's drag-and-drop feature allows you to drag files from your computer or file system onto your browser and attach them to your Confluence pages or blog posts. You can drag-and-drop:

• multiple files at once.
• image, multimedia and PDF files, and Office documents.

When you drag-and-drop files onto the different Confluence views, you get the following results:

Requirements for the Confluence Drag-and-Drop Feature

• Confluence's drag-and-drop feature relies on your browser's support for the drag-and-drop functionality of HTML5.

• Some browsers, such as Internet Explorer 9, Firefox 3.5 and Safari 4 do not support the drag-and-drop functionality of HTML5. For these browsers, Confluence will attempt to use the drag-and-drop functionality provided by Google Gears.
  
  
  • The first time you try to drag and drop a file into one of these browsers, Confluence will prompt you to install Google Gears into your browser. Refer to the prompt below for more information. For more details on the installation requirements for Google Gears, refer to Google's own How to install instructions.
    
    
  • Please check the Google Gears website for the most up-to-date browser support details.
    To check if Google Gears is already installed on your computer, refer to Google's own How to check if Gears is installed instructions.
    
    

    Supported Web Browsers

    Please ensure that you are using one of the web browsers supported by Confluence. If you are using an unsupported browser or browser version, some features may not work correctly. You can find the list of supported web browsers and browser versions on this page: Supported Platforms.

• Some older Confluence themes do not support Confluence's drag-and-drop feature.
  
  
  • Supported themes: Confluence Default theme, Documentation theme, Easy Reader theme.
    
    
  • Themes that are not supported: Left Navigation theme, Clickr theme. You cannot drag and drop attachments into spaces that use these themes.

Prompt to Install Google Gears

If you are using a browser that does not support the drag-and-drop feature, and Google Gears has not yet been installed:

• When you attempt to drag and drop a file into Confluence (but not the editor), you will be prompted with the following message:
  
  Screenshot: Generic Confluence Prompt to Install Google Gears
  
  
  
  Click OK to proceed with the Google Gears installation.

• When you attempt to drag and drop a file into the editor, you will be prompted with the following message:
  
  Screenshot: Confluence Prompt to Install Google Gears
  
  
  
  

  Save any drafted content before continuing with the installation of Google Gears. The installation process will replace your current Confluence page and you will need to restart your browser after the Google Gears installation has completed.

  Click Proceed with Installation to install Google Gears.

Initial Use with Google Gears

When adding an attachment to a page or blog post in your Confluence site for the first time (after Google Gears has been installed), you will be prompted to allow Google Gears to trust your Confluence site as shown in the following screenshot. If this warning message appears, select the I trust this site. Allow it to use Gears check box and click Allow.

Screenshot: Google Gears Security Prompt

Disabling Drag-and-Drop

If you are a Confluence administrator and wish to disable Confluence's drag-and-drop feature for any reason, please refer to Disabling Drag-and-Drop for details.

Related Topics

Attaching Files to a Page
Add many files to a page at once
Using the Editor
Displaying Images
Working with Links
Disabling Drag-and-Drop