# set_post_thumbnail()

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

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

## Сигнатура

```php
set_post_thumbnail( int|WP_Post $post, int $thumbnail_id ): int|bool
```

## Описание

Устанавливает миниатюру записи (изображение записи) для указанной записи.

## Параметры

- `$post` `int|WP_Post` — обязательный. Идентификатор записи или объект записи, к которому нужно прикрепить миниатюру.
- `$thumbnail_id` `int` — обязательный. Миниатюра для прикрепления.

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

`int|bool`

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

Файл: `wp-includes/post.php:8114`

```php
function set_post_thumbnail( $post, $thumbnail_id ) {
	$post         = get_post( $post );
	$thumbnail_id = absint( $thumbnail_id );
	if ( $post && $thumbnail_id && get_post( $thumbnail_id ) ) {
		if ( wp_get_attachment_image( $thumbnail_id, 'thumbnail' ) ) {
			return update_post_meta( $post->ID, '_thumbnail_id', $thumbnail_id );
		} else {
			return delete_post_meta( $post->ID, '_thumbnail_id' );
		}
	}
	return false;
}
```

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

- 3.1.0 — Introduced.

## Связанные

Использует: [`wp_get_attachment_image`](https://chugunov.pro/api-wordpress/functions/wp_get_attachment_image/), [`update_post_meta`](https://chugunov.pro/api-wordpress/functions/update_post_meta/), [`delete_post_meta`](https://chugunov.pro/api-wordpress/functions/delete_post_meta/), [`absint`](https://chugunov.pro/api-wordpress/functions/absint/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/).
Используется в: `WP_REST_Posts_Controller::handle_featured_media`, [`wp_ajax_set_attachment_thumbnail`](https://chugunov.pro/api-wordpress/functions/wp_ajax_set_attachment_thumbnail/), [`wp_ajax_set_post_thumbnail`](https://chugunov.pro/api-wordpress/functions/wp_ajax_set_post_thumbnail/), [`wp_insert_post`](https://chugunov.pro/api-wordpress/functions/wp_insert_post/), `wp_xmlrpc_server::mw_editPost`, `wp_xmlrpc_server::mw_newPost`, `wp_xmlrpc_server::_insert_post`.

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