This page includes the following:
How to insert an image using the Rich Text editor
- Open the page on which you want to see the image.
- From the Insert options, select Image.
- Select the image to insert. There is a search function to find images on other Confluence pages.
- Complete the image properties. You can resize the image and link to the original, add a border, and add effects.
- In the XHMTL markup, add alt text for the image.
How to insert an image using wiki markup
Confluence supports several HTML image attributes. Some can be inserted in the XHTML after an image is inserted using the Rich Text editor. These attributes may also be used by inserting the image using wiki markup. The steps are
- From the Insert options, select Wiki Markup.
- In the editing window, enter the wiki markup.
- Click Insert.
Examples are shown, followed by a list of HTML image attributes supported in Confluence.
Action | Markup | Displayed Image |
|---|---|---|
Display an image flush right with a black border | !nciplogo_40p.jpg|align=right,border=2,bordercolor=black,alt="NCIP logo"! |
|
| Display an image attached to a page in another wiki space, centered | !EVS:EVS Wiki^EVSTiny80.jpg|align=center,alt="EVS logo"! |
|
| Display an image attached to another page in the same wiki space | !Wiki FAQs, Tips and Guidelines^nciplogo_40p.jpg|alt="NCIP logo"! |
HTML image attributes supported in Confluence
- align — 'left', 'right', 'bottom', 'center', 'top'.
- border — width of the border (in pixels).
- bordercolor — specify the color of the image border created with the "border" tab by name or by hex value.
- hspace — amount of whitespace to be inserted to the left and right of the image (in pixels).
- vspace — amount of whitespace to be inserted above and below the image (in pixels).
- width — width of the image (in pixels). Supersedes natural width of the image.
- height — height of the image (in pixels). Supersedes the natural height of the image.
- title — descriptive text for the image, which is displayed when the pointer hovers over the image
- alt — alternative text (required), which is included in the HTML code. This text is retrievable via search, and contributes to accessibility of the page for text-only viewing.
How to resize an image
Typically, images up to 13 inches wide are displayed without causing the horizontal scroll bar to appear when the browser is full-screen. Wider images make scrolling necessary and may cause the page to be displayed improperly so that lines no longer wrap.
You can attach images at any size and change the display size in Confluence. Thus, you can use the original image capture which provides the best resolution with the least loss of data. Try specifying the width only, in even increments calculated based on 72 pixels per inch:
Image Width in Inches = 13, Width in Pixels = 936
Image Width in Inches = 12, Width in Pixels = 864
Image Width in Inches = 11, Width in Pixels = 792
Image Width in Inches = 10, Width in Pixels = 720
Image Width in Inches = 9, Width in Pixels = 648
Image Width in Inches = 8, Width in Pixels = 576
You can also use the buttons to resize in the image properties panel.
Tip
If the image is not rendered properly in the browser, it's necessary to resize in a tool, either to the exact dimensions or to a percentage of the original size. If the image was imported from Microsoft Word, removing the exact dimensions from the import often solves the problem. If the image then becomes too large, resize the image to a percentage of the original size.
