Images and SVG
An image is always a fill on a layer; there is no image layer type. This page lists formats and limits, what an image or an SVG becomes depending on how it arrives, how the document lists and organizes its images, and how a crop is applied. Also called: bitmaps, assets.
Image formats and limits
Image fills accept PNG, JPEG, WebP and SVG files. GIF and every other format are not accepted: a drop on the canvas without a supported file shows Dropped files did not include any supported image types., and unsupported files dropped together with supported ones are skipped with a message.
An image whose longer side is over 4000 px is scaled down to 4000 px. The scaled copy is re-encoded: PNG and SVG files become PNG, JPEG and WebP files become JPEG at 75% quality, so a large WebP loses its transparency. One upload can be at most 40 MB, measured after the scale-down; a larger image is refused with a message. If an upload fails, a message says so and the image is removed again; undo does not bring it back. An SVG converted to layers is scaled down to fit 3000 × 3000 px.
Getting images in
Where: drop files on the canvas, paste them with Ctrl + V, or Properties panel → Fill → open a fill → type Image → the Upload image button. Images already in the document come from the asset list.
- A dropped or pasted bitmap becomes a rectangle named after the file, at the image's pixel size, with the image as a Fit fill.
- The fill's image settings show the image's name: the name of the file it came from, or
imagewith the format's extension, such asimage.png, for a pasted image without a file name, such as a screenshot. Dropping or pasting the same image again shows it under the same name. - A drop lands in the frame under the pointer: in a Flex frame at that position, in a Grid frame in that cell. A drop creates a layer, unless
Ctrlis held, which fills the layer under the pointer instead. - A paste lands where any paste lands. With shapes selected, a pasted bitmap can become their fill instead of a new layer.
The asset list
Where: the Assets tab at the top of the left sidebar, next to Layers.
- The list shows every image in the document, including images no layer uses at the moment. Each row shows a thumbnail and the image's name.
- Images dropped or pasted on the canvas and the images of an import sit at the top level of the list. Folders stay closed until you click them.
- Layers pasted from another document bring their images along in the same folders. A document imported before the asset list existed keeps its imported images in the Imported folder.
- Thumbnails load as their rows come into view, so a closed folder costs nothing to keep.
- The Find images field above the list keeps the images whose name or folder contains what you type and opens the folders holding them.
Escclears it. - A warning icon (tooltip Another image has the same path) marks two images with the same name in the same folder. Names compare without regard to letter case. This happens only when two people add or rename images at the same moment, or when undo or redo brings an image back after another image took its path. The Validation console lists both until one is renamed.
The selected images
Click a row to select an image; Ctrl-click adds or removes one, and Shift-click selects the rows in between. A section below the list shows the selection:
- One image shows larger, with its name, its folder, its size in pixels, its format and its file size. Used by 3 layers selects the layers whose fills or strokes show it. When they are on several pages, the link reads Used by 5 layers on 2 pages and the search dialog lists them by page instead, as Find uses does. A component's layer counts once, however many instances show it. Used by a deleted component means only a deleted component uses the image, which its instances still show.
- Replace image puts another file in its place for every layer that shows it; the name and the folder stay. Crops are scaled to the new image, or removed when its aspect ratio differs, so that the fitting decides what shows.
- Download original saves the file as it was uploaded, under the image's name. With several images selected, Download saves them as a zip, in their folders.
- Delete deletes the selected images. When a layer uses one, a dialog asks first and says how many layers will show a missing image instead. The Validation console lists each of those layers until you undo the deletion or choose another image.
Organizing images
- Double-click a name to rename an image or a folder. A name can't contain
/or be.or.., and two images in one folder can't share a name, regardless of letter case. - Drag images or folders onto a folder to move them into it, or onto the empty space below the rows to take them out of every folder. Move to folder in the section below the list moves the selected images.
- Renaming or moving a folder renames or moves every image in it. Layers keep showing their images, whatever their name or folder. Each rename and move is one undo step.
- Add images next to Find images → Upload images… adds files outside every folder, Upload to new folder… asks for a folder name and then for the files, and New folder… makes an empty folder. Right-click a folder for the same inside it. Image files dropped onto a folder upload into it.
- An uploaded file always becomes an image of its own, even when the document has the same picture already. A name that is taken in the folder gets a number, such as
shoe 2.jpg. - An empty folder exists only in your list until an image goes in: nobody else sees it, and it is gone when you reload.
Using images from the list
- Drag images from the list onto the canvas to place them. Each becomes a rectangle named after the image, at its size, as a drop of its file does, but it shows the image already in the list instead of adding another. An SVG image stays an image fill.
- The preview of the selected images below the list drags them too, wherever their rows can go.
- Hold
Ctrl(⌘on macOS) while dropping to give the innermost layer under the pointer the image as its only fill, fitted. Shapes, vectors, boolean groups and frames take it, but text doesn't, so the frame under the text does. The layer is outlined while you hold the key, and in an instance the fill becomes an override. Image files dragged in from outside work the same way. Where no layer takes a fill, the drop places a layer. - Drop an image onto Fill or Stroke in the Properties panel to add it as a paint between the rows where you drop it, on every selected layer. Where the list shows mixed paints, the image becomes the only paint.
- Drop an image onto an open fill to make that fill show it; a color or gradient turns into an image fill.
- A
Ctrldrop and a drop onto a list or a fill take the first of several dragged images. - In a fill's image settings, Choose from assets opens the list's folders and Find images field; click an image to choose it. Click the image's name to show it in the asset list.
Cropping
Where: in the fill's image settings, the Adjust image crop button next to the fitting dropdown → Crop image dialog.
- Reset sets the rectangle back to the whole image, within the selected aspect ratio. The layer changes only on Done; closing the dialog discards the change.
- SVG image fills can't be cropped: the button is disabled (tooltip Crop unavailable for SVG images).
- Uploading a new image into the fill clears the crop. The crop applies on the canvas, in preview and in every export.
SVG
- Dropped on the canvas or pasted, an SVG file is converted into editable layers inside a frame named after the file. So is pasted SVG source text that starts with
<svgand ends with</svg>. - Chosen with the Upload image button of a fill, it stays an image fill.
| The conversion | Elements and attributes |
|---|---|
| Converts | svg and g to frames, where an svg inside another one sits at its x and y, scales its viewBox into its size and clips to it unless its overflow is visible; use to a copy of what it references in the same file, a symbol becoming such an svg; path, polygon, polyline to vector layers; rect to a rectangle, with rx/ry as its corner radius (the smaller of the two); circle, ellipse to an oval; line to a line. Fill, stroke and their opacity, element and group opacity as the layer's Opacity, stroke width, dash pattern and blend mode, from attributes and style rules; the transform attribute and the CSS transform, translate, rotate and scale properties, around their transform-origin. linearGradient, radialGradient. In a filter: feGaussianBlur as Blur, feDropShadow as Drop Shadow. clipPath and mask, as described below the table. |
| Ignores | text, image, pattern, and a use of another file. |
A clip-path that is one plain rectangle becomes a frame that clips to that rectangle. Any other clip path, and every mask, becomes layers with Use as mask next to the content they cut out. A mask cuts by its opacity, so a luminance mask comes out right only where it is white. Clip paths and masks in objectBoundingBox units, and masks made only of ignored elements, are left out.
Export
PNG, JPEG and SVG export and Copy as are on Export images and SVG.
Related
- Export images and SVG — PNG, JPEG and SVG files of your layers, with crops applied.
- Import — images and vectors of an imported design file.
- Keyboard shortcuts — macOS forms of the shortcuts above.