---
updatedAt: 2026-03-19T18:26:34.000Z
agentTools:
  projectIndex: https://developers.miro.com/llms.txt
---

# Image

Add images to a board: specify a URL or drop a file on a board.

The image item adds an image on a board in one of the following ways:

* Drag and drop a locally stored image file on the target board.
* Copy-paste to the board a URL pointing to an image file.

> 📘
>
> If the Miro account associated with image resources hosted on Miro is deleted, the images are stored on Miro for 180 days after the account deletion.

Image item:

<img alt="" src="https://files.readme.io/d5b96b2-image-item.png" width="400"><br>\
**Figure 1.** Image item.

## Known limitations

### Miro REST API

The Miro REST API returns geometry data only for images that were originally uploaded through the REST API.

Currently, the REST API doesn't return [geometry data](https://developers.miro.com/miro-ea/reference/geometry) for images that were added to a board:

* Without explicitly specifying image width and height.
* By copy-pasting the URL to the board, or through the Miro Web SDK.

This behavior may change in the future to return image geometry through the REST API, regardless of the image upload mechanism.

### Miro Web SDK

It's possible to initially set [`url`](https://developers.miro.com/miro-ea/docs/image_image-1#url), but it's not possible to update it.

`/path/to/local-image.png`: relative URL paths pointing to local assets aren't supported.\
💡 As a workaround:

* [Use the REST API to upload a local image](https://developers.miro.com/miro-ea/reference/create-image-item-using-file-from-device) to Miro.
* Encode a local image to a base64 data URL string, and then assign it to `url`.\
  This feature is: **<span><img alt="Experimental feature" src="https://files.readme.io/d32aaa2-experimental-icon-bw.svg" width="24" ></span> Experimental**

## See also

* [Web SDK reference](https://developers.miro.com/miro-ea/docs/image_image-1)
* [REST API reference](https://developers.miro.com/miro-ea/reference/rest-api-create-image-from-url)

# Sibling pages

* [Boards](https://developers.miro.com/miro-ea/docs/boards.md)
* [Board items](https://developers.miro.com/miro-ea/docs/board-items.md)
* [App card](https://developers.miro.com/miro-ea/docs/app-card.md)
* [Card](https://developers.miro.com/miro-ea/docs/card-1.md)
* [Connector](https://developers.miro.com/miro-ea/docs/connector_intro.md)
* [Embed](https://developers.miro.com/miro-ea/docs/embed-2.md)
* [Events](https://developers.miro.com/miro-ea/docs/events.md)
* [Frame](https://developers.miro.com/miro-ea/docs/frame-1.md)
* [Mind map (Experimental)](https://developers.miro.com/miro-ea/docs/mind-maps.md)
* [Preview](https://developers.miro.com/miro-ea/docs/preview-1.md)
* [Shape](https://developers.miro.com/miro-ea/docs/shape-1.md)
* [Sticky note](https://developers.miro.com/miro-ea/docs/stickynote-1.md)
* [Storage](https://developers.miro.com/miro-ea/docs/storage.md)
* [Text](https://developers.miro.com/miro-ea/docs/text-1.md)
* [Tag](https://developers.miro.com/miro-ea/docs/tag-concepts.md)

# What's next

To discover the REST API and the Web SDK feature sets and to get app ideas, check their tutorial sections.

* [REST API tutorials](https://developers.miro.com/miro-ea/docs/rest-api-how-tos.md)
* [Miro Web SDK tutorials](https://developers.miro.com/miro-ea/docs/web-sdk-how-tos.md)