# post_thumbnail_url

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

Тип: хук-фильтр.
Появился в версии: 5.9.0.

## Сигнатура

```php
apply_filters( 'post_thumbnail_url', string|false $thumbnail_url, int|WP_Post|null $post, string|int[] $size )
```

## Описание

Фильтрует URL миниатюры записи.

## Параметры

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

## Фильтруемое значение

URL миниатюры записи или false, если запись не существует.

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

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

```php
return apply_filters( 'post_thumbnail_url', $thumbnail_url, $post, $size );
```

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

- 5.9.0 — Introduced.

## Связанные

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

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