This documentation has moved. For the most recent documentation, check out Please update your bookmarks and links.

Skip to end of metadata
Go to start of metadata


The HTML Image macro allows the display of an image within a page, with extended properties such as an 'alt' tag and an image map feature.


Click Insert > Other Macros.

Select the HTML Image macro from the provided list.

Complete the desired fields.



Alt Text

Defines a short description of the contents




Image URL(src)Defines the URL of the image sourcestringnone


HeightSets height of the imagestringnone(error)
WidthSets width of the imagestringnone(error)
Server-side MapDefines the image as a server-side image mapcheckboxunselected(error)
Client-side MapDefines the ID for a client-side map, linking to HTML on the page that includes this mapstringnone(error)
Long DescriptionA URL to a page which contains a long description of the content stringnone(error)

Specifies a unique ID to be added to the button

CSS ClassSpecifies a CSS Class to be added to the element
Inline StyleAn optional inline style sheet to apply to the tagstringnone(error)
TitleText to display in a tooltipstringnone(error)
Text DirectionSpecifies the text directionsingle selectnone(error)
Language CodeSpecifies the language property, e.g. en, de, fr.stringnone(error)

The URL parameter must be specified for this macro to work.

The macro will then appear on the page.


Basic Example

To display an HTML image on a page

Resulting in:


Using Client Side Image Map

To use the client-side image map parameter, the Atlassian HTML Macro must be enabled. This action requires an administrator and the security risks should be understood before doing so. 

Click here to read the documentation for HTML Macro. Once this is complete, the HTML Macro can be added to a page and an image map can be inserted. 

The name of the map should be the same as the 'Client-side image map' parameter for the HTML Image Macro, as follows. 

Top of page

  • No labels