# pre_upload_error

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

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

## Сигнатура

```php
apply_filters( 'pre_upload_error', bool $error )
```

## Описание

Возврат истинного значения фактически прерывает загрузку медиафайла, возвращая это значение в виде ошибки 500.

## Параметры

- `$error` `bool` — обязательный. Следует ли перехватить загрузку медиафайла. Значение по умолчанию: false.

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

Следует ли перехватить загрузку медиафайла. Значение по умолчанию: false.

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

Файл: `wp-includes/class-wp-xmlrpc-server.php:6491`

```php
$upload_err = apply_filters( 'pre_upload_error', false );
```

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

- 2.1.0 — Introduced.

## Связанные

Используется в: `wp_xmlrpc_server::mw_newMediaObject`.

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