This page last changed on Sep 14, 2011 by pwatson.

An image can be displayed on a Confluence page in the following cases:

  • the image is attached to the page.
  • the image is attached to another page of the same Confluence site, even if in another space.
  • the image is on a remote webpage.

Once the image is displayed on the page, you can:

  • move the image to a new position on the page simply by cutting and pasting.
  • click on the image to change how it appears on the page.

You can also link from an image to another page.

Displaying an image attached to the page

There are several methods for attaching image files to a page.
Once you have attached an image to a page, there are different methods for choosing where on the page the image should appear:

Using the 'Insert Image' dialog

Once an image is attached to the page, you can edit the page to choose where the image should appear.

To position an attached image on the page:

  1. While editing the page, position the cursor where you want to place the image.
  2. Choose Insert > Image and click on the Attached Images tab.
  3. Select the required image and click Insert (or just double-click on the image).

Using autocomplete

Once an image is attached to the page, you can use autocomplete while editing the page to choose where the image should appear.

To position an attached image on the page:

  1. While editing the page, position the cursor where you want to place the image.
  2. Trigger the autocomplete function by typing '!'.
  3. Choose the image from the list that appears.

Using drag-and-drop

Depending on the browser you are using, you can attach and position an image in one step. While you are editing a page, simply drag-and-drop an image file on to the page. The image is attached to the page and is placed at the current cursor position.

Displaying an image attached to a different page

You can display an image that is attached to a different page of the same Confluence site, as long as you know the name of the image. This approach can make it easier to manage your images by allowing you to keep them all in the same place.

To display an image attached to a different page:

  1. While editing the page, position the cursor where you want to place the image.
  2. Choose Insert > Image and click on the Search tab.
  3. Type in the name of the image.
  4. Choose whether to search the current space or All Spaces and click Search.
  5. Select the required image from the search results and click Insert.

Alternatively, you can simply cut and paste the image from another page.

Displaying an image from a remote webpage

You can display an image from a remote webpage on your Confluence page, without needing to attach it to your page. You need to know the URL for the image, not for the webpage it appears on. Note that you should have permission to use that image on your page.

To display an image located on a webpage:

  1. While editing the page, position the cursor where you want to place the image.
  2. Choose Insert > Image and click on From the Web.
  3. Type in the URL for the image. An example is: http://www.atlassian.com/software/confluence/images/icon_customerslove_big.png
  4. Click Preview to check that the URL and image are correct.
  5. Click Insert.

Alternatively, you can simply cut and paste the image from a webpage.

Controlling the image appearance

When editing the page, click on the image to show the image properties panel. The panel allows you to set the display size for the image and choose whether the image has a border. See also Linking from an Image.

To set the size of the image, do one of the following:

  • Click on one of the size 'preset' buttons (the image width in pixels is displayed to the left).
  • Click on the image size text and enter a new image width, in pixels.

Note that images are displayed as thumbnails.

To add a border to the image:

  • Click Border in the image properties panel.

Screenshot: The image properties panel beneath an image

For further information regarding image appearance see Confluence Wiki Markup.

Related Topics

Using Images
Working with Links
Working with Attachments


Document generated by Confluence on Sep 19, 2011 02:30