# image_add_caption_text

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

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

## Сигнатура

```php
apply_filters( 'image_add_caption_text', string $caption, int $id )
```

## Описание

Примечание: если текст подписи пуст, шорткод caption не будет добавлен к HTML-коду изображения при вставке в редактор.
Передача пустого значения также предотвращает применение фильтра ‘image_add_caption_shortcode’ в конце image_add_caption().

## Параметры

- `$caption` `string` — обязательный. Исходный текст подписи.
- `$id` `int` — обязательный. Идентификатор вложения.

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

Исходный текст подписи.

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

Файл: `wp-admin/includes/media.php:204`

```php
$caption = apply_filters( 'image_add_caption_text', $caption, $id );
```

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

- 4.1.0 — Introduced.

## Связанные

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

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