# wp_insert_attachment_data

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

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

## Сигнатура

```php
apply_filters( 'wp_insert_attachment_data', array $data, array $postarr, array $unsanitized_postarr, bool $update )
```

## Описание

Фильтрует данные записи вложения перед их обновлением в базе данных или добавлением в неё.

## Параметры

- `$data` `array` — обязательный. Массив экранированных слэшами, очищенных и обработанных данных записи вложения.
- `$postarr` `array` — обязательный. Массив экранированных слэшами и очищенных данных записи вложения, но не обработанных.
- `$unsanitized_postarr` `array` — обязательный. Массив экранированных слэшами, но *неочищенных* и необработанных данных записи вложения в том виде, в каком они были изначально переданы в wp_insert_post() .
- `$update` `bool` — обязательный. Обновляется ли существующая запись вложения.

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

Массив экранированных слэшами, очищенных и обработанных данных записи вложения.

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

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

```php
$data = apply_filters( 'wp_insert_attachment_data', $data, $postarr, $unsanitized_postarr, $update );
```

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

- 6.0.0 — The $update parameter was added.
- 5.4.1 — The $unsanitized_postarr parameter was added.
- 3.9.0 — Introduced.

## Связанные

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

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