> For the complete documentation index, see [llms.txt](https://docs.datacake.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.datacake.de/dashboards/widgets/image-widget.md).

# Image Widget

## Overview

The Image Widget allows you to upload any image you have into your dashboard. You can also add a link to an external (or internal) site to your image. Powerful tool to add photos of your devices, location, branding, etc.

## Configuration

When adding a new Image Widget, you will simply get the option to upload an image from your local storage. You can either drag-and-drop an image onto the lined square, or click on "Change".

A folder will open on your PC. Browse until you find the proper image (it can be a diagram, logo, photo, or whatever image you want).

{% hint style="info" %}
Supported formats are gif, .jpg, .jpeg, .png, .svg, .webp. The maximum size permitted is 10 Mb. The platform will escale the image for performance purposes.
{% endhint %}

You can then select how the image should be displayed. Select either "Contain", to let the image take the platform scale the image to fit into the widget, or "Cover", to stretch out the image to fill out the full size of the widget.

<figure><img src="/files/awv8wefvflwW5Ut5C2VU" alt=""><figcaption></figcaption></figure>

Finally decide if you want to Hide background or Add a link to your image. When selecting to "Add link" you will be presented with an empty field, where you can simply paste the URL (exactly as you would enter it on your browser, with https\:// and everything). You can then enable the option to "Open the link in a new tab", or not.

Tint color option allows you to color the background of the widget, as always.

Save the changes and you are ready to enjoy your image in your dashboard!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.datacake.de/dashboards/widgets/image-widget.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.