> ## Documentation Index
> Fetch the complete documentation index at: https://wonder.design/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Images and SVGs

> Add images to the canvas, fit and crop them in their frames, reset them to their own size, and paste, recolor and turn SVGs into icons.

Bring your own images and SVGs onto the canvas, then fit, crop and recolor them. To make new images or vectors with AI, see [Generate images and vectors](https://wonder.design/docs/generate-images-and-vectors.md).

**Before you start** · Web and desktop · Free plan

## Add an image

Drag image files from your computer onto the canvas, or copy an image and paste it with <kbd>⌘</kbd> <kbd>V</kbd>.

Each image becomes a frame with the image as its fill, named after the file and placed at half its pixel size, so it looks sharp on high-resolution screens. Several files are placed side by side.

| | |
| - | - |
| Formats | PNG, JPEG, GIF, WebP and SVG |
| Size | Up to 100 MB and 50 megapixels per image, on every plan |

SVG files become SVG layers instead. See [Paste or drop an SVG](#paste-or-drop-an-svg).

## Add an image to a frame

1. Select a frame.
2. In the **Background Fill** section of the properties panel, choose **Image** as the fill type.
3. Click **Upload image** and pick a file, or drop one on the picker. To reuse an image that's already on the canvas, click **Select on canvas** and click it.

To change the image later, hover over it in the picker and click **Replace**. An SVG you pick here is turned into a PNG fill.

## Fit an image in its frame

In the image picker, **Image fit** sets how the image fills its frame:

| Option | What it does |
| - | - |
| **Fill** | Stretches the image to the frame's width and height. |
| **Cover** | Fills the frame, keeping the image's proportions. Edges that don't fit are cut off. |
| **Contain** | Shows the whole image inside the frame, keeping its proportions. |
| **None** | Shows the image at its own size. |

When the image can be cropped, **Image fit** also offers **Crop**, which starts cropping it.

## Crop an image

1. Double-click the image, select it and click **Crop** in the **Image actions** bar, or choose **Crop** under **Image fit**.
2. Drag the crop handles, or pick a shape under the aspect ratio menu: **Custom**, **Original**, **Square (1:1)**, **Circle (1:1)**, 4:3, 3:2, 16:9, 3:4, 2:3 or 9:16.
3. Use the **Scale image** slider to zoom the image inside the crop, and **Resize to fit image** to fit the frame to the whole image again.
4. Click **Apply crop**. **Cancel** leaves the image as it was.

You can crop a frame whose fill is an image and that has no layers inside it.

## Reset an image to its size

To size an image back to its own pixel width and height, select it and:

* right-click and choose **Reset image size**, or press <kbd>⇧</kbd> <kbd>R</kbd>;
* or double-click a corner handle. The opposite corner stays where it is.

An image larger than its parent frame is shrunk to fit inside it. Because new images are placed at half size, resetting a newly added image doubles it.

## Paste or drop an SVG

Drag `.svg` files onto the canvas, or copy SVG code and paste it with <kbd>⌘</kbd> <kbd>V</kbd>. Each one becomes an SVG layer at its own size: a file is named after the file, and pasted code is named **Pasted SVG**.

## Recolor an SVG

1. Select the SVG layer.
2. In the **Colors** section of the properties panel, find the color you want to change. The section lists every color in the SVG.
3. Click its swatch and pick a new color, or type a value.

The new color replaces that color everywhere in the selected SVGs. Parts drawn in the text color (`currentColor`) follow the layer's text color. An SVG with no colors to change shows **No editable colors**.

## Turn an SVG into an icon

Add an SVG to the file's icon library to reuse it across the file:

* right-click the SVG layer and choose **Add to icon library** (or **Add 3 to icon library** for several);
* or click **+** (**Add to library**) in the **Icon** section of the properties panel.

The layer stays where it is, linked to the new icon. If the same SVG is already in the library, Wonder links the existing icon instead of adding a copy. One-color icons follow the text color, so you can recolor them and bind them to a color variable. See [Icons](https://wonder.design/docs/icons.md#add-icons) for the library itself.

## Export an image

Select the layer, click **+** (**Add export**) in the **Export** section of the properties panel, pick a format and size, and click **Export as…** for that format. PNG, JPG, WebP and PDF are always offered; SVG only when every selected layer is an SVG.

## If something goes wrong

* **This image format isn’t supported.** Choose a PNG, JPEG, SVG, GIF or WebP file.
* **Image is too large**, with **Choose an image of 100 MB or less.** or **Choose an image of 50 megapixels or less, or scale this one down.** Resize or compress the image, then add it again.
* **Couldn't upload the image.** The upload didn't finish. Check your connection and add the image again.
* **This SVG file is too complex to add.** Simplify it in your design tool, or choose another file.
* **Clipboard content is too large to paste.** The SVG code you copied is over the paste limit. Save it as an `.svg` file and drop that on the canvas instead.
* **Crop isn't offered.** Crop works on a frame with a visible image fill and no layers inside it, and not on a locked layer or an SVG.

## Related

* [Generate images and vectors](https://wonder.design/docs/generate-images-and-vectors.md)
* [Icons](https://wonder.design/docs/icons.md)
* [Text and fonts](https://wonder.design/docs/text-and-fonts.md)
* [Shaders](https://wonder.design/docs/shaders.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.