# get_tag()

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

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

## Сигнатура

```php
get_tag( int|WP_Term|object $tag, string $output = OBJECT, string $filter = 'raw' ): WP_Term|array|WP_Error|null
```

## Описание

Если передать в параметр $tag объект, который считается объектом строки метки, полученной из базы данных, данные метки будут закэшированы.
Если передать в $tag целочисленный идентификатор метки, эта метка будет извлечена из базы данных, если она ещё не в кэше, и возвращена.
Если посмотреть на get_term(), оба типа проходят через несколько фильтров и в итоге очищаются в зависимости от значения параметра $filter.

## Параметры

- `$tag` `int|WP_Term|object` — обязательный. Идентификатор метки или объект.
- `$output` `string` — необязательный, по умолчанию `OBJECT`. Требуемый тип возврата. Один из OBJECT, ARRAY_A или ARRAY_N, что соответствует объекту WP_Term, ассоциативному массиву или числовому массиву соответственно.
- `$filter` `string` — необязательный, по умолчанию `'raw'`. Как очищать поля метки. По умолчанию 'raw'.

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

`WP_Term|array|WP_Error|null` — WP_Error

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

Файл: `wp-includes/category.php:341`

```php
function get_tag( $tag, $output = OBJECT, $filter = 'raw' ) {
	return get_term( $tag, 'post_tag', $output, $filter );
}
```

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

- 2.3.0 — Introduced.

## Связанные

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

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