# get_post_thumbnail_id()

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

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

## Сигнатура

```php
get_post_thumbnail_id( int|WP_Post|null $post = null ): int|false
```

## Описание

Получает ID миниатюры записи.

## Параметры

- `$post` `int|WP_Post|null` — необязательный, по умолчанию `null`. ID записи или объект WP_Post. По умолчанию — глобальная переменная $post.

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

`int|false`

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

Файл: `wp-includes/post-thumbnail-template.php:53`

```php
function get_post_thumbnail_id( $post = null ) {
	$post = get_post( $post );

	if ( ! $post ) {
		return false;
	}

	$thumbnail_id = (int) get_post_meta( $post->ID, '_thumbnail_id', true );

	/**
	 * Filters the post thumbnail ID.
	 *
	 * @since 5.9.0
	 *
	 * @param int|false        $thumbnail_id Post thumbnail ID or false if the post does not exist.
	 * @param int|WP_Post|null $post         Post ID or WP_Post object. Default is global `$post`.
	 */
	return (int) apply_filters( 'post_thumbnail_id', $thumbnail_id, $post );
}
```

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

- 5.5.0 — The return value for a non-existing post was changed to false instead of an empty string.
- 4.4.0 — $post can be a post ID or WP_Post object.
- 2.9.0 — Introduced.

## Связанные

Использует: [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/), [`get_post_meta`](https://chugunov.pro/api-wordpress/functions/get_post_meta/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/).
Используется в: `WP_REST_Posts_Controller::prepare_links`, `WP_REST_Posts_Controller::prepare_item_for_response`, [`get_the_post_thumbnail_caption`](https://chugunov.pro/api-wordpress/functions/get_the_post_thumbnail_caption/), [`get_oembed_response_data_rich`](https://chugunov.pro/api-wordpress/functions/get_oembed_response_data_rich/), [`get_the_post_thumbnail_url`](https://chugunov.pro/api-wordpress/functions/get_the_post_thumbnail_url/), `WP_Media_List_Table::column_title`, [`edit_form_image_editor`](https://chugunov.pro/api-wordpress/functions/edit_form_image_editor/), [`get_media_item`](https://chugunov.pro/api-wordpress/functions/get_media_item/), [`has_post_thumbnail`](https://chugunov.pro/api-wordpress/functions/has_post_thumbnail/), [`update_post_thumbnail_cache`](https://chugunov.pro/api-wordpress/functions/update_post_thumbnail_cache/), [`get_the_post_thumbnail`](https://chugunov.pro/api-wordpress/functions/get_the_post_thumbnail/), [`prepend_attachment`](https://chugunov.pro/api-wordpress/functions/prepend_attachment/), [`wp_prepare_attachment_for_js`](https://chugunov.pro/api-wordpress/functions/wp_prepare_attachment_for_js/), [`wp_playlist_shortcode`](https://chugunov.pro/api-wordpress/functions/wp_playlist_shortcode/), `wp_xmlrpc_server::mw_getPost`, `wp_xmlrpc_server::mw_getRecentPosts`, `wp_xmlrpc_server::_prepare_post`.

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