# `GSLayer.backgroundImage`

*Instance Property*

A reference image attached directly to the layer.

## Declaration

```swift
var backgroundImage: GSBackgroundImage? { get set }
```

```objc
@property (nonatomic, strong) GSBackgroundImage * backgroundImage;
```

[See also `backgroundImage` in the Python API](https://docu.glyphsapp.com/#GSLayer.backgroundImage)

```python
pyobjc_instanceMethods.backgroundImage() -> GSBackgroundImage
pyobjc_instanceMethods.setBackgroundImage_(backgroundImage: GSBackgroundImage)
```

## Discussion

This image is independent of the layer’s editable background content.

## See Also

### Background Image

- [`GSBackgroundImage`](/Core/GlyphsCore/GSBackgroundImage) — A reference image attached directly to a layer.
- [`GSLayer.hasBackgroundImage`](/Core/GlyphsCore/GSLayer/hasBackgroundImage) — Whether a background image is attached directly to the layer.
- [`GSLayer addBackgroundImageWithURL:`](/Core/GlyphsCore/GSLayer/addBackgroundImageWithURL:) — Adds an image from a file URL.