# remove_query_arg()

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

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

## Сигнатура

```php
remove_query_arg( string|string[] $key, false|string $query = false ): string
```

## Описание

Важно: возвращаемое значение remove_query_arg() по умолчанию не экранируется. Вывод следует экранировать в последний момент с помощью esc_url() или аналогичной функции, чтобы снизить риск межсайтового скриптинга (XSS).

## Параметры

- `$key` `string|string[]` — обязательный. Ключ или ключи запроса, которые нужно удалить.
- `$query` `false|string` — необязательный, по умолчанию `false`. Если false, используется текущий URL.

## Возвращаемое значение

`string`

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

Файл: `wp-includes/functions.php:1220`

```php
function remove_query_arg( $key, $query = false ) {
	if ( is_array( $key ) ) { // Removing multiple keys.
		foreach ( $key as $k ) {
			$query = add_query_arg( $k, false, $query );
		}
		return $query;
	}
	return add_query_arg( $key, false, $query );
}
```

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

- 1.5.0 — Introduced.

## Связанные

Использует: [`add_query_arg`](https://chugunov.pro/api-wordpress/functions/add_query_arg/).
Используется в: [`_wp_get_site_editor_redirection_url`](https://chugunov.pro/api-wordpress/functions/_wp_get_site_editor_redirection_url/), `WP_Customize_Manager::set_return_url`, [`wp_admin_bar_customize_menu`](https://chugunov.pro/api-wordpress/functions/wp_admin_bar_customize_menu/), [`wp_admin_canonical_url`](https://chugunov.pro/api-wordpress/functions/wp_admin_canonical_url/), [`wp_media_attach_action`](https://chugunov.pro/api-wordpress/functions/wp_media_attach_action/), [`wp_prepare_themes_for_js`](https://chugunov.pro/api-wordpress/functions/wp_prepare_themes_for_js/), `WP_List_Table::view_switcher`, `WP_List_Table::pagination`, `WP_List_Table::print_column_headers`, [`set_screen_options`](https://chugunov.pro/api-wordpress/functions/set_screen_options/), [`wp_dashboard_setup`](https://chugunov.pro/api-wordpress/functions/wp_dashboard_setup/), `WP_Comments_List_Table::get_views`, `Walker_Nav_Menu_Edit::start_el`, [`wp_nav_menu_item_post_type_meta_box`](https://chugunov.pro/api-wordpress/functions/wp_nav_menu_item_post_type_meta_box/), [`wp_nav_menu_item_taxonomy_meta_box`](https://chugunov.pro/api-wordpress/functions/wp_nav_menu_item_taxonomy_meta_box/), `WP_Customize_Manager::customize_preview_settings`, [`wp_nonce_ays`](https://chugunov.pro/api-wordpress/functions/wp_nonce_ays/), [`wp_referer_field`](https://chugunov.pro/api-wordpress/functions/wp_referer_field/), [`get_pagenum_link`](https://chugunov.pro/api-wordpress/functions/get_pagenum_link/), [`wp_video_shortcode`](https://chugunov.pro/api-wordpress/functions/wp_video_shortcode/), [`_remove_qs_args_if_not_in_url`](https://chugunov.pro/api-wordpress/functions/_remove_qs_args_if_not_in_url/), [`redirect_canonical`](https://chugunov.pro/api-wordpress/functions/redirect_canonical/), [`_post_format_link`](https://chugunov.pro/api-wordpress/functions/_post_format_link/), [`get_cancel_comment_reply_link`](https://chugunov.pro/api-wordpress/functions/get_cancel_comment_reply_link/).

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