This page provides an overview of Confluence's drag-and-drop feature and details on how to set up this feature in Confluence.

On this page:

Drag-and-Drop Overview

Confluence's drag-and-drop functionality allows you to drag files onto your browser to attach them to your Confluence pages or blog posts. With the drag-and-drop feature, you can:

1. Attach multiple files onto a page or blog post when viewing its attachments list. See Attaching Files to a Page for more information.
   
   
2. Attach multiple files onto a page or blog post when in view mode. See Attaching Files to a Page for more information.
   
   
3. Attach multiple files onto a page or blog post when in edit mode. See Rich Text Editor Overview for more information.
   
   
4. Embed Office Documents (including Office 2007 files) and PDF's when in edit mode. See Displaying Office Files in Confluence for more information.
   
   
5. Embed or attach multiple images into a page or blog post when in edit mode. See Inserting an Image for more information.
   
   
6. Cancel individual file uploads.

Requirements for Confluence's Drag-and-Drop Feature

Please read the following requirements, to see if the drag-and-drop feature will work on your computer.

• Some themes do not support Confluence's drag-and-drop feature. It works in the Confluence Default theme, but not in the Left Navigation theme or the Clickr theme. You cannot drag and drop attachments into spaces that use the Left Navigation theme or the Clickr theme.

• The first time you try to drag and drop a file, your browser will prompt you to install Google Gears onto your PC. (See more details about the prompt below.) Google Gears provides your web browser with the functionality needed to use Confluence's drag-and-drop feature. If you run into difficulty, please follow the instructions on the Google Gears site to install this application on your computer. You need Internet access to install Google Gears. See the requirements of installing Google Gears. Unfortunately, at the moment there does not seem to be an offline installer available.

• Google Gears supports Firefox, Internet Explorer and Safari browsers on Windows, Mac and Linux. Please check the Google Gears website for the most up-to-date browser support details.

• If you are unable to install Google Gears and you use Firefox as your web browser, you may wish to try the Atlassian Drag and Drop Firefox plugin. This plugin (which only works with Firefox) provides most of the features offered by Confluence's official drag-and-drop feature. Refer to the Atlassian Drag and Drop Firefox plugin page.)

Prompt to Install Google Gears

• If you have not yet installed Google Gears and you attempt to drag and drop a file into Confluence (with the exception of the rich text 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.

• If you have not yet installed Google Gears and you attempt to drag and drop a file into the rich text editor, you will be prompted with the following message:
  
  Screenshot: Confluence Prompt to Install Google Gears from the Rich Text Editor
  
  

  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

When adding an attachment to a page or blog post in your Confluence site for the first time in a given browser, 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 the 'Allow' button.

Screenshot: Google Gears Security Prompt

Disabling Drag-and-Drop

Your Confluence system administrator may wish to disable the drag-and-drop feature for a variety of reasons, one of which might be to disable the prompt to install Google Gears on their Confluence user's browsers and operating systems.

If you are a Confluence system administrator and wish to disable the drag-and-drop feature, you will need to access the Plugin Manager in your Confluence installation's 'Administration' section and disable the entire 'Confluence Drag and Drop Plugin'. Refer to Installing and Configuring Plugins Manually for details on accessing the Plugin Manager and disabling entire plugins or plugin modules.

Confluence system administrators can also disable the 'drop zone' that appears on the 'Attachments' view by disabling the 'View Attachments Drop Zone' module of this plugin. This removes the drop zone on the 'Attachments' view whilst retaining the drag-and-drop functionality.

RELATED TOPICS

Attaching Files to a Page
Add many files to a page at once
Rich Text Editor Overview
Rich Text-Inserting an image
Rich Text-Creating and removing a link