# add_rewrite_tag()

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

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

## Сигнатура

```php
add_rewrite_tag( string $tag, string $regex, string $query = '' )
```

## Описание

Параметр $query необязателен. Если он опущен, необходимо вызывать это на хуке ‘init’ или раньше. Это связано с тем, что $query по умолчанию равен $tag=, и для работы нужно добавить новую переменную запроса.

## Параметры

- `$tag` `string` — обязательный. Имя нового тега перезаписи.
- `$regex` `string` — обязательный. Регулярное выражение, на которое подставляется тег в правилах перезаписи.
- `$query` `string` — необязательный, по умолчанию `''`. Строка, добавляемая к переписанному запросу. Должна заканчиваться на '='.

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

Файл: `wp-includes/rewrite.php:162`

```php
function add_rewrite_tag( $tag, $regex, $query = '' ) {
	// Validate the tag's name.
	if ( strlen( $tag ) < 3 || '%' !== $tag[0] || '%' !== $tag[ strlen( $tag ) - 1 ] ) {
		return;
	}

	global $wp_rewrite, $wp;

	if ( empty( $query ) ) {
		$qv = trim( $tag, '%' );
		$wp->add_query_var( $qv );
		$query = $qv . '=';
	}

	$wp_rewrite->add_rewrite_tag( $tag, $regex, $query );
}
```

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

- 2.1.0 — Introduced.

## Связанные

Использует: `WP::add_query_var`, `WP_Rewrite::add_rewrite_tag`.
Используется в: `WP_Sitemaps::register_rewrites`, `WP_Taxonomy::add_rewrite_rules`, `WP_Post_Type::add_rewrite_rules`.

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