Описание
Выводит значение указанного поля.
Интуитивно понятная и мощная, эта функция позволяет вывести значение любого поля из любого места. Обратите внимание: эта функция аналогична echo get_field().
Параметры
the_field($selector, [$post_id], [$format_value]);$selector(string) (Обязательный) Имя поля или ключ поля.$post_id(mixed) (Необязательный) ID записи, в которой сохранено значение. По умолчанию используется текущая запись.$format_value(bool) (Необязательный) Применять ли логику форматирования. По умолчанию — true.
Примеры
Вывод значения из текущей записи
В этом примере показано, как вывести значение поля "text_field" из текущей записи.
<h2><?php the_field('text_field'); ?></h2>Вывод значения из определённой записи
В этом примере показано, как вывести значение поля "text_field" из записи с ID = 123.
<h2><?php the_field('text_field', 123); ?></h2>Проверка существования значения
В этом примере показано, как проверить существование значения перед его выводом.
<?php if( get_field('text_field') ): ?>
<h2><?php the_field('text_field'); ?></h2>
<?php endif; ?>Получение значения из разных объектов
В этом примере показаны различные допустимые значения $post_id, определяющие, где сохранено значение.
$post_id = false; // текущая запись
$post_id = 123; // ID записи = 123
$post_id = "user_123"; // ID пользователя = 123
$post_id = "term_123"; // ID термина = 123
$post_id = "category_123"; // то же, что выше
$post_id = "option"; // страница настроек
$post_id = "options"; // то же, что выше
the_field( 'my_field', $post_id );Примечания
До выхода ACF 5.11 функцию the_field() можно было использовать для вывода значений настроек или метаданных объектов, не связанных с полями ACF. Это создавало проблемы с безопасностью, поскольку настройки сайта могли быть раскрыты. Функция the_field() также могла выводить значения полей, которые больше не зарегистрированы в ACF.
Это было изменено в ACF 5.11. Подробнее см. в ресурсе Изменения функций полей ACF в версии 5.11.
Обновлено: 30.09.2026