Confluence 5.0 has reached end of life
Check out the [latest version] of the documentation
This page describes the drag-and-drop functionality in Confluence, and the browser configurations needed to support that functionality.
Overview of the drag-and-drop features
Confluence supports these forms of drag-and-drop:
Drag-and-drop within the editor. Working inside the editor panel, you can drag an image or a macro and drop it into a different location on the page.
- Drag-and-drop for external images and files. You can drag a file from a location outside Confluence, and drop it directly into the editor. For example, try it with images, video files, audio files, Office documents, and PDF files. The contents of the file will be embedded into the page or blog post.
Drag-and-drop within the editor
Working within the editor panel, you can drag an image or a macro from one location on the page and drop it into a different location on the page. Hover your cursor over the image or the macro placeholder. The cursor changes to a drag-and-drop icon and you can click the image or macro and drag it to a new location.
If you want to abandon the drag-and-drop action, press Escape. The image/macro will return to its original position.
Requirements for internal drag-and-drop
For the drag-and-drop of images and macros in the editor, Confluence supports the following browsers: Chrome, Firefox, and Internet Explorer 9. (Drag and drop in the editor does not work in Internet Explorer 8.)
On this page:
Related pages:
Drag-and-drop for external images and files
You can 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:
Confluence View | Result |
---|---|
Files are attached | |
Files are attached | |
Edit | Files are attached, and embedded at the cursor position |
Requirements for external drag-and-drop
- For dragging files from your computer or file system onto your browser, your browser must support the drag-and-drop functionality of HTML5. Browsers such as Firefox 3.5, Safari 4 and Internet Explorer 9 offer limited HTML5 functionality and don't support drag-and-drop.
- Some older Confluence themes do not support Confluence's drag-and-drop feature.
- Supported themes: Confluence Default theme, Documentation theme.
- Themes that are not supported: Left Navigation theme, Clickr theme. You cannot drag and drop attachments into spaces that use these themes.
Disabling drag-and-drop for external files
- If you wish to disable the drag-and-drop feature, you can disable the entire Confluence Drag and Drop Plugin. See Disabling and enabling apps.
- You can also disable the drop zone that appears on the 'Attachments' view or the image dialog box, by disabling the View Attachments Drop Zone or Image Dialog Drop Zone modules of the above plugin. This will remove these drop zones while retaining Confluence's drag-and-drop functionality.