---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.3
alternate:
  - https://divkit.tech/docs/en/concepts/divs/2/div-image-background.md
  - https://divkit.tech/docs/ru/concepts/divs/2/div-image-background.md
---
> **Documentation Index:** Fetch the complete configuration index at https://divkit.tech/docs/en/llms.txt

# div-image-background
Background image.

## Parameters
| Parameters | Description |
| --- | --- |
| `image_url` | <p>**string**</p><p>Required parameter.</p><p>Image URL.</p><p>The value must be a valid URL.</p> |
| `type` | <p>**string**</p><p>Required parameter.</p><p>The value must always be `image`.</p> |
| `alpha` | <p>**number**</p><p>Image transparency.</p><p>Restriction for the value `x`: `x >= 0.0 && x <= 1.0`.</p><p>Default value: `1.0`.</p> |
| `content_alignment_horizontal` | <p>**string**</p><p>Horizontal image alignment.</p><p>Possible values: `left`, `center`, `right`, `start`, `end`.</p><p>Default value: `center`.</p> |
| `content_alignment_vertical` | <p>**string**</p><p>Vertical image alignment.</p><p>Possible values: `top`, `center`, `bottom`, `baseline`.</p><p>Default value: `center`.</p> |
| `filters` | <p>**array**</p><p>Image filters.</p><p>List of possible values:<li>[div-blur](div-blur.md#div-blur)</li><li>[div-filter-rtl-mirror](div-filter-rtl-mirror.md#div-filter-rtl-mirror)</li></p> |
| `preload_required` | <p>**bool_int**</p><p>Background image must be loaded before the display.</p><p>Default value: `false`.</p><p>Available platforms: Android, iOS.</p> |
| `scale` | <p>**string**</p><p>Image scaling.</p><p>Possible values: `fill`, `no_scale`, `fit`, `stretch`.</p><p>Default value: `fill`.</p> |

<details>
<summary>JSON</summary>

```json
{
  type*: "image",
  alpha: "number",
  content_alignment_horizontal: "string",
  content_alignment_vertical: "string",
  filters: [ div-filter, ... ],
  image_url*: "string",
  preload_required: "bool_int",
  scale: "string"
}
```
</details>