# add_settings_error()

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

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

## Сигнатура

```php
add_settings_error( string $setting, string $code, string $message, string $type = 'error' )
```

## Описание

Часть Settings API. Используется для показа пользователям сообщений о проблемах валидации настроек, отсутствующих настройках и о чём угодно ещё.
Ошибки настроек следует добавлять внутри функции $sanitize_callback , определённой в register_setting() для конкретной настройки, чтобы дать обратную связь об отправке.
По умолчанию сообщения отображаются сразу после отправки, вызвавшей ошибку.
Дополнительные вызовы settings_errors() можно использовать для показа ошибок даже при первом открытии страницы настроек.

## Параметры

- `$setting` `string` — обязательный. Слаг настройки, к которой относится эта ошибка.
- `$code` `string` — обязательный. Слаг для идентификации ошибки. Используется как часть атрибута 'id' в HTML-выводе.
- `$message` `string` — обязательный. Отформатированный текст сообщения для отображения пользователю (показывается внутри стилизованных тегов и ).
- `$type` `string` — необязательный, по умолчанию `'error'`. Тип сообщения, управляет HTML-классом. Возможные значения: 'error', 'success', 'warning', 'info'. Значение по умолчанию 'error'.

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

Файл: `wp-admin/includes/template.php:1870`

```php
function add_settings_error( $setting, $code, $message, $type = 'error' ) {
	global $wp_settings_errors;

	$wp_settings_errors[] = array(
		'setting' => $setting,
		'code'    => $code,
		'message' => $message,
		'type'    => $type,
	);
}
```

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

- 5.3.0 — Added warning and info as possible values for $type.
- 3.0.0 — Introduced.

## Связанные

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

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