Child pages
  • Using Drag-and-Drop in Confluence
Skip to end of metadata
Go to start of metadata

This page provides an overview of Confluence's drag-and-drop feature and details of its requirements.

On this page:

Overview of the Drag-and-Drop Feature

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

Requirements for the Confluence Drag-and-Drop Feature

  • Confluence's drag-and-drop feature relies on functionality provided by HTML5. If your browser fully supports HTML5, Confluence will use this browser capability for drag-and-drop.

  • Some browsers, such as Internet Explorer 7 and 8, Firefox 3.5 and Safari 4 do not fully support HTML5. Therefore, Confluence will attempt to use the functionality provided by Google Gears for drag-and-drop.

    • 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.
      (tick) To check if Google Gears is already installed on your computer, refer to Google's own How to check if Gears is installed instructions.

    • If you are unable to install Google Gears or Confluence's drag-and-drop feature has been disabled on your site and you use Firefox as your web browser, you may wish to try the Atlassian Drag and Drop Firefox plugin. As described on this link's page, this plugin (which only works with Firefox) provides most of the features offered by Confluence's official drag-and-drop feature.

      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 HTML5 and Google Gears has not yet been installed, 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.
  • 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 with Google Gears

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

Screenshot: Google Gears Security Prompt

Google Gears is not supported on Safari. See CONF-20032@JIRA for updates.

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.


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
Disabling Drag-and-Drop

  • No labels