You can display an image from either a file attached to the Confluence page, or from another location.

This page shows you how to display an image using Confluence Notation, also known as Wiki Markup.

Create the page first

If you want to display an image from a file attached to the page, you must create and save the page first. Confluence will only allow you to attach a file when you have already created the page.

Using the 'Insert Image' icon

Instead of Wiki Markup, you can use the 'Insert Image' icon. This behaves in a similar way for both the Wiki Markup and the Rich Text editor, as described in Inserting an image. Currently, the 'Thumbnail' and 'Alignment' selections are not displayed when in Wiki Markup mode.

To follow the instructions below, you need to edit in 'Wiki Markup' mode.

Displaying an image from a remote location

You need to know the URL from which the image can be linked.

What you need to type

What you will get

!http://www.atlassian.com/images/confluence_feature.gif!

Displaying an image attached to a page

  • First, attach the image to the page.
  • Now you can display the attached image:

    What you need to type

    What you will get


    !fish.gif!

Displaying an image attached to another Confluence page

What you need to type

What you will get


!Space attachments directory^fish.gif!

Where 'Space Attachments Directory' is the name of the page containing the attachment.

Usage example

What if you want to upload an image only once, but display it on many pages?

  • Attach the image to a page, such as our page called the 'Space attachments directory'.
  • Link to the uploaded image using the syntax described above.
    (info) To view the image, the user needs to have view permission for the page to which it is attached.

Displaying an image attached to page in a difference space

!SPACE:my page^myimg.jpg!


Formatting an image

What you need to type

What you will get


!fish.gif|align=right,border=2,bordercolor=blue!

For any image, you can also specify attributes of the HTML image tag as a comma-separated list of name=value pairs. Available image tags include:

  • align — available values are 'left', 'right', 'bottom', 'center', 'top'.
  • border — specify the width of the border (in pixels).
  • bordercolor — use this with the above 'border' tag to specify the colour of the image border. Specify the colours by name or by hex value. See more information about web colours. (Available with Confluence 2.6.2 and later.)
  • hspace — specify the amount of whitespace to be inserted to the left and right of the image (in pixels).
  • vspace — specify the amount of whitespace to be inserted above and below the image (in pixels).
  • width — specify the width of the image (in pixels). This will override the natural width of the image.
  • height — specify the height of the image (in pixels). This will override the natural height of the image.
RELATED TOPICS

Linking an image to another page or URL
Rich Text-Inserting an image
Attaching Files to a Page
Image File Formats
Thumbnail Macro
Gallery Macro

Take me back to Confluence 2.6 User Guide

  • No labels

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.