Как записать SEO-поля элемента инфоблока через IPROPERTY_TEMPLATES?

На практике cron заливает 500 товаров из 1С: в логе CIBlockElement::Update вернул true, NAME и цены на месте, а в браузере title пустой. Типичная проблема: разработчик ищет ELEMENT_META_TITLE в GetByID и пишет meta в PROPERTY_VALUES — записи не работает, эффекта нет. SEO в 1С-Битрикс живет в ключе IPROPERTY_TEMPLATES, а не в обычных полях элемента. Ниже — запись шаблонов через Update/Add, чтение ElementValues::getValues(), наследование от раздела, сброс кеша clearValues() и чек-лист, чтобы view-source совпал с API.

IPROPERTY_TEMPLATES - специальный ключ массива полей CIBlockElement::Add/Update в 1С-Битрикс: Управление сайтом для записи SEO-шаблонов элемента инфоблока (ELEMENT_META_TITLE, ELEMENT_META_DESCRIPTION, ELEMENT_META_KEYWORDS, ELEMENT_PAGE_TITLE, alt/title картинок). Вычисленное значение с учетом наследования от раздела и инфоблока читают через Bitrix\Iblock\InheritedProperty\ElementValues::getValues(), не через GetByID. Сегодня: откройте вкладку SEO в админке, перенесите шаблон в IPROPERTY_TEMPLATES при Update, проверьте getValues() и view-source.

Речь про 1С-Битрикс: Управление сайтом на вашем хостинге, не про Bitrix24 CRM. Элемент инфоблока - товар, новость, услуга в каталоге CMS. Создаете карточку с нуля - CIBlockElement::Add с IPROPERTY_TEMPLATES в том же массиве. Меняете поля без SEO - CIBlockElement::Update. Свойства элемента (цена, бренд) - отдельная тема: SetPropertyValues, не путайте с SEO-шаблонами.

Разберите, когда SEO-поля нужно писать через API

SEO-вкладка в админке работает для ручной правки. Программная запись meta title элемента инфоблока битрикс нужна при импорте из 1С, cron-обмене, миграции каталога и массовой генерации шаблонов. API (Application Programming Interface) здесь - PHP-скрипт, который дергает методы Битрикса без браузера.

NAME и PREVIEW_TEXT - поля карточки; SEO meta - наследуемые шаблоны в b_iblock_iproperty с версии 14.0.0, не пользовательские свойства.

Делайте: API для массовых сценариев. Не делайте: писать ELEMENT_META_TITLE в PROPERTY_VALUES - это другой слой данных.

Что такое IPROPERTY_TEMPLATES и когда он нужен

IPROPERTY_TEMPLATES - ключ в $arFields при Add/Update: не готовый title, а шаблон "{=this.NAME} - Каталог". Битрикс вычисляет итог по цепочке инфоблок → раздел → элемент.

Нужен, когда скрипт задает SEO-шаблон. Не нужен, если хватает наследования от раздела.

Запишите SEO через CIBlockElement::Update и Add

Полный набор ключей IPROPERTY_TEMPLATES для элемента:

1. Модуль и поля: Loader::includeModule('iblock'), IBLOCK_ID, NAME и другие поля элемента — как обычно.
2. SEO: добавьте ключ IPROPERTY_TEMPLATES с нужными ELEMENT_META_*.
3. Update: $el = new CIBlockElement; $el->Update($elementId, $arFields);
4. Проверка: ElementValues::getValues() — см. следующий раздел.

<?php
use Bitrix\Main\Loader;
use Bitrix\Iblock\InheritedProperty\ElementValues;

Loader::includeModule('iblock');
$el = new CIBlockElement;
$arFields = [
    'NAME' => 'Смартфон X200',
    'IPROPERTY_TEMPLATES' => [
        'ELEMENT_META_TITLE' => '{=this.NAME} - купить, цена, отзывы',
        'ELEMENT_META_DESCRIPTION' => '{=this.PREVIEW_TEXT}',
        'ELEMENT_PAGE_TITLE' => '{=this.NAME}',
    ],
];
if ($el->Update(4821, $arFields)) {
    $seo = (new ElementValues(7, 4821))->getValues();
    // $seo['ELEMENT_META_TITLE'] - вычисленный title
}

Типичная ошибка: meta в PROPERTY_VALUES - SEO-вкладка молчит. Пустая строка в IPROPERTY_TEMPLATES сбрасывает шаблон к родителю - проверьте наследование.

Делайте: обновляйте только нужные ключи. Не делайте: передавать пустые SEO-поля при импорте.

Прочитайте вычисленные SEO через ElementValues::getValues()

CIBlockElement::GetByID возвращает NAME, CODE, PREVIEW_TEXT. ELEMENT_META_TITLE там нет - это не колонка элемента, а вычисляемое SEO-поле. Для inheritedproperty elementvalues используйте D7-класс ElementValues.

<?php
use Bitrix\Iblock\InheritedProperty\ElementValues;

$values = (new ElementValues($iblockId, $elementId))->getValues();
// ELEMENT_META_TITLE, ELEMENT_META_DESCRIPTION, ELEMENT_META_KEYWORDS
// ELEMENT_PAGE_TITLE, alt/title картинок

getValues() - вычисленное значение; IPROPERTY_TEMPLATES - шаблон. Пустой шаблон элемента наследует title раздела.

Делайте: сверяйте getValues() с view-source. Не делайте: искать meta в GetByID.

Настройте наследование: инфоблок, раздел, элемент

Цепочка: инфоблок → раздел → элемент. Разделы - SectionValues::getValues(). Диагностика: админка → getValues() → view-source → кеш catalog.element.

Делайте: baseline getValues() до импорта. Не делайте: заливать пустые IPROPERTY_TEMPLATES на весь каталог.

Сравните ORM ElementTable::save() и classic API

iblocks API: $element->save() не принимает IPROPERTY_TEMPLATES.

Делайте: для SEO в D7 комбинируйте save() полей и Update с IPROPERTY_TEMPLATES. Не делайте: ждать ELEMENT_META_TITLE от ElementTable::save().

Вызовите clearValues() после массового импорта

getValues() кеширует вычисление - после пакетного Update вызовите ElementValues::clearValues() и сбросьте кеш catalog.element. Иначе в API title свежий, а в браузере старый.

1. Импорт: Update только для измененных ID.
2. Сброс: clearValues() по списку элементов.
3. Контроль: getValues() = view-source.

Делайте: clearValues() в конце cron. Не делайте: верить только true от Update.

Проверьте чек-лист: получите совпадение API и браузера

1. Запись: IPROPERTY_TEMPLATES, не PROPERTY_VALUES.
2. Чтение: getValues() — title, PAGE_TITLE, description.
3. Кеш и браузер: clearValues() + сброс компонента, view-source = getValues().
4. Alt: ELEMENT_*_PICTURE_FILE_ALT в исходнике.

Аудит обмена - контакты. Делайте: лог getValues() для 10 SKU. Не делайте: закрывать тикет по true в Update.

Автор: Максим Мольков, разработчик 1С-Битрикс.
Источники: iblocks API, IPROPERTY_TEMPLATES, ElementValues::getValues, наследуемые SEO-свойства (проверено 03.08.2026).

Частые вопросы

Что дальше: создание элемента с SEO - CIBlockElement::Add → чтение карточки - GetByID → свойства - SetPropertyValues → разделы и SectionValues - CIBlockSection.