# image parameter (skin)

Source: https://ref.dm-lang.org/skin/param/image

### Applies to
- [Button](https://ref.dm-lang.org/skin/control/button.md)
- [Label](https://ref.dm-lang.org/skin/control/label.md)
- [Main](https://ref.dm-lang.org/skin/control/main.md)
- [Output](https://ref.dm-lang.org/skin/control/output.md)


### Format
> `'*file*'`

A background image to show in this control.

In the Output control this image is always tiled.

> [!note]
> 
> Icons displayed in the output control will not show the background image underneath their transparent parts, but will instead show the background color.

For Label and Main, use [image-mode](https://ref.dm-lang.org/skin/param/image-mode.md) to control how the image is displayed.

### See also
- [image-mode parameter](https://ref.dm-lang.org/skin/param/image-mode.md)
- [keep-aspect parameter](https://ref.dm-lang.org/skin/param/keep-aspect.md)