> For the complete documentation index, see [llms.txt](https://handbook.musescore.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://handbook.musescore.org/3/formatting/images.md).

# Images

Embed **Images** onto a score as cover art or as symbols that are not found in any [Palettes](/3/basics/palettes.md) or the [Master palette](/3/advanced-topics/master-palette.md) window (check its **Symbol category** as last resort). MuseScore supports the following formats:

* Scalable Vector Graphics (\*.svg): the recommended format, but does not support SVG shading, blurring, clipping or masking technologies, see [Musescore Versions Reference](https://musescore.org/en/handbook/developers-handbook/references/versions-reference) and [Qt 5.9: Rendering SVG Files](https://doc.qt.io/archives/qt-5.9/svgrendering.html)
* Bitmap (\*.bmp)
* Portable Network Graphics (\*.png) supports transparency (alpha channel)
* JPEG (\*.jpg and \*.jpeg)
* TIFF (\*.tif or \*.tiff) supports transparency but unpredictable, see [discussion](https://musescore.org/en/node/320619).

Does not support the following formats at all:

* Graphics Interchange Format (\*.gif)
* WebP (\*.webp)
* X PixMap (\*.xpm)

## Add image

Use one of the following options:

* Drag-and-drop an image file (from outside MuseScore) either into a vertical or horizontal [frame](/3/formatting/frames.md), or onto a **measure**, a **note** or a **rest** on the score.
* Right-click on a frame, select **Add -> Picture**, then pick an image from the file selector.

Once imported, it can be added to any palette and reapplied to other scores easily, see [added to a palette](/3/basics/palettes.md#add-from-an-opened-score).

## Cut/copy and paste image

1. Click on an image in the score.
2. Apply any of the standard copy/cut [commands](/3/basics/copy-and-paste.md#accessing-the-commands).
3. Click on a note, rest or frame.
4. Apply any of the standard paste [commands](/3/basics/copy-and-paste.md#accessing-the-commands).

## Modify image

To modify the width/height of an image, double-click it and drag any of the handles. If you want to adjust width or height separately, untick "Lock aspect ratio" first in the [Inspector](/3/basics/inspector.md). Toggle the "Size in staff space units" checkbox to switch between proportional unit and absolute value, see [Layout and formatting](/3/formatting/layout-and-formatting.md).

You can adjust the position of an image by simply dragging it.

## See also

* [Image capture](/3/formatting/image-capture.md)
* [Custom palettes](/3/basics/palettes.md#customize-palette-contents)

## External links

* [How to create an ossia with image capture](https://musescore.org/en/node/46226) (MuseScore HowTo)
* [How to create an ossia with another staff](https://musescore.org/en/node/46236) (MuseScore HowTo)


---

# 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://handbook.musescore.org/3/formatting/images.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.
