# HTML Img

## Description

The HTML Img tag macro shows an image on your page. You have several options to influence it’s display.

## Adding the Macro

1. Edit your page.
2. Select “+” => Other macros
3. Type in “html” in the Search box
4. Select the “HTML Img” macro

## Macro Options

### **Image URL**

If the image is from an external source, specify it’s link here.

### **Use Attachment**

Check this option if the Image URL shall be ignored and an attached image of the page should be used instead.

### **Image File**

Select the attached image file.

### **Alignment**

Select the alignment of the image corresponding to its surrounding elements.

### **Alternate Text**

Enter an alternative text for the image. It will be displayed in case the image cannot be loaded.

### **Height**

Enter a custom height for the display. Use a numeric value. It is interpreted as pixels. If Width is not set, the browser will automatically adjust the proportion.

### **Width**

Enter a custom width for the display. Use a numeric value. It is interpreted as pixels. If Height is not set, the browser will automatically adjust the proportion.

### **Element ID**

You can specify an element ID here. It must be unique on your page.

### **CSS Classes**

You can specify CSS class names here, separated by blank.

### **Inline Styles**

You can specify inline CSS properties here. Each one has to end with a semicolon.

### **Tooltip Title**

Enter a simple text here that will popup as a tooltip when the mouse is hovered over the element.

### **Image Map**

You can specify an Image Map here tha can define certain areas of the image. The name must start with a hash, e.g. “#myMap”.

Read more about it

### **Custom Attributes**

You can enter fully specified custom attributes here separated by blanks, e.g.: data-animal=”cat” data-color=”red”.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://lewe.gitbook.io/html-and-aui-toolkit-for-confluence/html-macros/html-img.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.