# Image

Display an image to the user. Images can be selected from many different sources, including from [*Connectors*](/connectors.md) (Databases, File systems and Web Services), Static Data or the Stadium Gallery.

Images uploaded to the Gallery are embedded within your application and are always available unless removed from the Gallery.

***

{% embed url="<https://www.youtube.com/embed/Eb3EABexs3A?autoplay=1&rel=0&vq=1080>" %}
*Add an Image*
{% endembed %}

***

### Properties

1. **Image**

   Select an image to display to the user.
2. **Alt Text**

   Text to display when the image is not available to be displayed.
3. **Height**

   Height the image should display at. If left empty (Default) it will display at its original height.
4. **Width**

   Width the image should display at. If left empty (Default) it will display at its original width.
5. **Visible**

   Set to False if you don't want this control to render on the page and be visible to the user.

{% hint style="warning" %} <mark style="color:red;">**Important**</mark> When using a SVG image that does not have width and height specified on the SVG itself, you *must* specify the width and height properties in Stadium for the image to display in your application.
{% endhint %}

***

### Events

1. **Click**

   An [Event](/features/events.md) that triggers when the image is clicked.


---

# 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://docs.stadium.software/controls/image.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.