# get_the_post_thumbnail_url()

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

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

## Сигнатура

```php
get_the_post_thumbnail_url( int|WP_Post|null $post = null, string|int[] $size = 'post-thumbnail' ): string|false
```

## Описание

Возвращает URL миниатюры записи.

## Параметры

- `$post` `int|WP_Post|null` — необязательный, по умолчанию `null`. ID записи или объект WP_Post. По умолчанию — глобальная переменная $post.
- `$size` `string|int[]` — необязательный, по умолчанию `'post-thumbnail'`. Зарегистрированный размер изображения, для которого нужно получить источник, либо плоский массив со значениями высоты и ширины. Значение по умолчанию — 'post-thumbnail'.

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

`string|false` — $size

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

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

```php
function get_the_post_thumbnail_url( $post = null, $size = 'post-thumbnail' ) {
	$post_thumbnail_id = get_post_thumbnail_id( $post );

	if ( ! $post_thumbnail_id ) {
		return false;
	}

	$thumbnail_url = wp_get_attachment_image_url( $post_thumbnail_id, $size );

	/**
	 * Filters the post thumbnail URL.
	 *
	 * @since 5.9.0
	 *
	 * @param string|false     $thumbnail_url Post thumbnail URL or false if the post does not exist.
	 * @param int|WP_Post|null $post          Post ID or WP_Post object. Default is global `$post`.
	 * @param string|int[]     $size          Registered image size to retrieve the source for or a flat array
	 *                                        of height and width dimensions. Default 'post-thumbnail'.
	 */
	return apply_filters( 'post_thumbnail_url', $thumbnail_url, $post, $size );
}
```

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

- 4.4.0 — Introduced.

## Связанные

Использует: [`wp_get_attachment_image_url`](https://chugunov.pro/api-wordpress/functions/wp_get_attachment_image_url/), [`get_post_thumbnail_id`](https://chugunov.pro/api-wordpress/functions/get_post_thumbnail_id/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`the_post_thumbnail_url`](https://chugunov.pro/api-wordpress/functions/the_post_thumbnail_url/).

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