# get_background_image()

URL: https://chugunov.pro/api-wordpress/functions/get_background_image/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.0.0.

## Сигнатура

```php
get_background_image(): string
```

## Описание

Получает фоновое изображение для произвольного фона.

## Возвращаемое значение

`string`

## Исходный код

Файл: `wp-includes/theme.php:1839`

```php
function get_background_image() {
	return get_theme_mod( 'background_image', get_theme_support( 'custom-background', 'default-image' ) );
}
```

## История изменений

- 3.0.0 — Introduced.

## Связанные

Использует: [`get_theme_support`](https://chugunov.pro/api-wordpress/functions/get_theme_support/), [`get_theme_mod`](https://chugunov.pro/api-wordpress/functions/get_theme_mod/).
Используется в: [`get_media_states`](https://chugunov.pro/api-wordpress/functions/get_media_states/), `Custom_Background::admin_page`, [`background_image`](https://chugunov.pro/api-wordpress/functions/background_image/), [`_custom_background_cb`](https://chugunov.pro/api-wordpress/functions/_custom_background_cb/), [`_delete_attachment_theme_mod`](https://chugunov.pro/api-wordpress/functions/_delete_attachment_theme_mod/), [`get_body_class`](https://chugunov.pro/api-wordpress/functions/get_body_class/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/get_background_image/