This page last changed on Dec 07, 2009 by ggaskell.
This page explains how to attach and insert an image, using the 'Insert Image' icon on the editor toolbar. You can also use Wiki Markup to insert an image.
 | Wiki Markup mode and Rich Text editor You can click the 'Insert Image' icon in either Wiki Markup mode or the Rich Text editor. The functionality described below is basically the same for both editing modes. |
Inserting Images
There are different ways to do this in Confluence:
To insert an image onto a page using the image browser,
- Click the 'Insert Image' icon
in the toolbar. The image browser ('Insert Image' window) opens.
Alternatively, you can open this window by right-clicking in the editor window and choosing 'Insert/Edit Image' from the context menu (if the right-click context menu is enabled) or by pressing Ctrl-M (if you use Internet Explorer for Windows). See Keyboard Shortcuts for key combinations used on other browsers and operating systems.
Choose either of the following options on the left-hand side of the window for inserting an image onto your page:
- Attached Images — allows you to:
1. Embed an image already attached to the page onto the Confluence page content area
2. Attach new images to the page. Images already attached to the page appear as thumbnails in this view.
- If you want to attach a new image to the page, use one of the following methods:
- 'Browse and Attach' feature:
- Click the 'Browse' button.
- Select your file from your computer or your network.
- Click the 'Open' button.
- 'Drag and Drop' feature:
This feature requires Google Gears to have been installed. Refer to the Drag-and-Drop topic for more information on configuring Confluence to use the drag and drop feature.
- Drag one or more file(s) accessible from your computer and drop it onto the Image Browser.
Screenshot: Dragging and Dropping an Image into the Insert Image Window
- If you want to preview an image:
- Browse and hover your mouse over the appropriate thumbnail of the image until a magnifying glass icon appears in the lower-right corner.
- Click on the thumbnail's magnifying glass icon and the image expands for previewing (see Screenshot 2 below). Click out of the image to return to the 'Attached Images' view.
- Once you have chosen the image you want to insert onto the page, click it to select it.
- From the Web — allows you to embed a remote image from the web (accessible via its URL) onto a Confluence page.
- Enter the URL of the image into the 'Image URL' text box. If you want to preview the image, click the 'Preview' button.
This preview function allows you to check if the URL is either correct or accessible by Confluence. Bear in mind that whenever the page is viewed, the image will be loaded and drawn from the other website as it is not stored within Confluence.
- If you want to control the placement of the image on the page, select a value from the 'Align' dropdown list. Available values are 'None' (i.e. default), 'Left', 'Right' and 'Centre'.
- If your image is not a web image and you want the Confluence page to display a smaller (thumbnail) version of your attached image rather than at full size, select the 'Thumbnail' check box. When the thumbnail is displayed on a page, it will also be hyperlinked such that when the user clicks the thumbnail, the image will expand to full-size in its own window.
- If you want to add a border around the image, ensure that the 'Border' check box has been selected (i.e. the default setting).
- Click 'OK' to insert the image on the Confluence page.
To embed an image onto a Confluence page using drag and drop,
This feature requires Google Gears to have been installed. Refer to the Drag-and-Drop topic for more information on configuring Confluence to use the drag and drop feature.
- Simply drag the image from your computer and drop it into the Rich Text Editor window. The image will be displayed in the position where you dropped it.
- Alternatively, you can also drag an image from another website and drop it into the Rich Text Editor window. Whenever the page is viewed, the image will be loaded and drawn from the other website as it is not stored within Confluence.
When embedding an image, only one image file can be dragged and dropped at a time.
 | This particular feature is not available in the Wiki Markup Editor. However, using the Wiki Markup Editor, you can still attach images to a page by dragging and dropping these files onto the Image Browser window. |
Screenshot 1: Inserting an Image - Browse Attached Images

Screenshot 2: Inserting an image - Previewing an Attached Image

RELATED TOPICS
Rich Text-Linking to an Attachment
Rich Text Editor Overview
Take me back to the Confluence User Guide.
|