---
title: Image Widget
description: Include an image or a gif in your Datadog dashboards.
breadcrumbs: Docs > Dashboards > Widgets > Image Widget
---

# Image Widget

The image widget allows you to embed an image on your dashboard. An image can be uploaded to Datadog or hosted where it can be accessed by URL. PNG, JPG, and GIF file formats are supported.

{% video
   url="https://docs.dd-static.net/images/dashboards/widgets/image/image.mp4" /%}

## Setup{% #setup %}

{% image
   source="https://docs.dd-static.net/images/dashboards/widgets/image/image_setup2.13b293831055a5fecb97a41693381fd7.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/dashboards/widgets/image/image_setup2.13b293831055a5fecb97a41693381fd7.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="Image setup" /%}

1. Upload your image or enter your image URL.
1. Select a preset template or customize the display options.

## API{% #api %}

This widget can be used with the **[Dashboards API](https://docs.datadoghq.com/api/latest/dashboards.md)**. See the following table for the [widget JSON schema definition](https://docs.datadoghq.com/dashboards/graphing_json/widget_json.md):

{% tab %}
ModelExample
{% tab title="-model" %}
Expand AllFieldTypeDescriptionhas_backgroundbooleanWhether to display a background or not.
default: `true`
has_borderbooleanWhether to display a border or not.
default: `true`
horizontal_alignenumHorizontal alignment. Allowed enum values: `center,left,right`marginenumSize of the margins around the image. **Note**: `small` and `large` values are deprecated. Allowed enum values: `sm,md,lg,small,large`sizingenumHow to size the image on the widget. The values are based on the image `object-fit` CSS properties. **Note**: `zoom`, `fit` and `center` values are deprecated. Allowed enum values: `fill,contain,cover,none,scale-down,zoom,fit,center`type [*required*]enumType of the image widget. Allowed enum values: `image`
default: `image`
url [*required*]stringURL of the image.url_dark_themestringURL of the image in dark mode.vertical_alignenumVertical alignment. Allowed enum values: `center,top,bottom`
{% /tab %}

{% tab title="example" %}

```json
{
  "has_background": true,
  "has_border": true,
  "horizontal_align": "string",
  "margin": "string",
  "sizing": "string",
  "type": "image",
  "url": "https://example.com/image.png",
  "url_dark_theme": "https://example.com/image-dark-mode.png",
  "vertical_align": "string"
}
```

{% /tab %}

{% /tab %}

## Further Reading{% #further-reading %}

- [Building Dashboards using JSON](https://docs.datadoghq.com/dashboards/graphing_json.md)