Как массово поменять картинки товаров в каталоге

Массово поменять картинки в каталоге 1С-Битрикс можно без ручного открытия каждой карточки. Способ выбирают по тому, откуда берутся изображения: из 1С по обмену, из CSV с внешними ссылками, по имени файла или через API. Ниже разбираем каждый вариант, его подводные камни и порядок действий, чтобы не потерять оригиналы и не сломать детейлы.

Как устроены изображения товара в каталоге

Прежде чем что-то менять массово, важно понимать структуру. У товара в инфоблоке есть два «системных» поля картинки: PREVIEW_PICTURE (анонс) и DETAIL_PICTURE (детальная). Дополнительные фото галереи хранятся в отдельном свойстве типа «Файл» с включённым флагом «множественное» — обычно оно называется MORE_PHOTO.

Физически файлы лежат в таблице b_file и на диске в /upload/iblock/. Когда вы «меняете» картинку, Битрикс создаёт новую запись в b_file, а старую помечает на удаление. Поэтому массовая замена — это не правка одного поля, а корректная перезапись файловых объектов через API или штатные механизмы.

Способ 1: обмен с 1С по CommerceML

Если каталог выгружается из «1С:Управление торговлей» или «1С:ERP», картинки логичнее менять на стороне 1С. При выгрузке в формате CommerceML 2 изображения кладутся в подкаталог рядом с import.xml, а в самом XML на них ссылается тег <Картинка>. Битрикс при обмене (/bitrix/admin/1c_exchange.php) сопоставляет товары по XML_ID и перезаписывает файлы.

• В карточке номенклатуры 1С прикрепляете новые изображения — при следующей выгрузке они заменят старые на сайте автоматически.
• Первое фото становится основным (DETAIL_PICTURE), остальные попадают в галерею MORE_PHOTO.
• Работает и для товаров, и для SKU — при условии, что предложения тоже выгружаются из 1С.

Способ 2: импорт CSV с внешними ссылками

Штатный мастер Магазин → Настройки → Экспорт/Импорт данных → Импорт CSV умеет подтягивать картинки по URL. В файле должно быть поле-идентификатор (артикул, ID или XML_ID), по которому товар находится, и столбец со ссылкой на изображение.

1. Готовите CSV: колонка ключа (например, Артикул) и колонка вида https://cdn.site.ru/foto/art123.jpg.
2. В мастере на шаге сопоставления связываете колонку ключа с полем поиска дубликатов, а колонку ссылки — с Детальная картинка или свойством галереи.
3. Ставите режим «обновлять существующие товары» и запускаете. Битрикс скачает файлы по ссылкам и подставит их.

Способ удобен, когда фото уже лежат на CDN или файловом сервере и есть таблица соответствия «артикул → ссылка». Для галереи из нескольких фото ссылки перечисляют в одной ячейке через разделитель, заданный в настройках профиля импорта.

Способ 3: привязка фото по имени файла (артикулу)

Частый кейс: поставщик прислал папку с фотографиями, где имя файла совпадает с артикулом — art123.jpg, art123_2.jpg. Готового пункта меню «привязать по имени» в Битрикс нет, но задача решается небольшим скриптом-агентом или через профиль импорта.

Логика скрипта проста: пройти по файлам в папке, из имени вырезать артикул, найти товар методом CIBlockElement::GetList по свойству CML2_ARTICLE, затем обновить картинку через CFile::MakeFileArray() и CIBlockElement::Update. Файлы с суффиксом _2, _3 складываете в массив свойства MORE_PHOTO.

Скрипт кладут в отдельный файл, подключают prolog_admin_before.php и запускают из-под администратора, либо оформляют как разовый агент. Так за один прогон обновляются тысячи товаров.

Способ 4: обновление через API (CFile и Update)

Самый гибкий вариант для нестандартной логики — прямая работа с API. Ключевые функции: CFile::MakeFileArray($path) формирует массив файла из пути или URL, а CIBlockElement::Update($id, $arFields) сохраняет его в поле товара.

• Для детальной картинки: $el->Update($id, array('DETAIL_PICTURE' => CFile::MakeFileArray($url)));
• Чтобы удалить старое фото и не плодить сироты в b_file, передают подмассив с флагом 'del' => 'Y' для прежнего FILE_ID.
• Множественное свойство обновляют через CIBlockElement::SetPropertyValuesEx с массивом файловых массивов.

В новом ядре (D7) для товаров и SKU удобнее работать через \Bitrix\Iblock\ElementTable и модуль catalog, но для операций с картинками старое API CFile/CIBlockElement остаётся рабочим и предсказуемым. Скрипт стоит гонять пакетами по 100–200 элементов, сбрасывая тегированный кэш командой CIBlockElement::Update (он инвалидируется автоматически).

Риски, кэш и как не потерять оригиналы

Массовая замена картинок — операция необратимая на уровне файлов, поэтому подготовка важнее самого прогона.

• Бэкап. Перед запуском снимите резервную копию БД и папки /upload/iblock/. Если что-то пойдёт не так, откат по XML_ID вернёт исходные файлы.
• Кэш. После обновления очистите кэш компонентов каталога и, при использовании ускорителей, сбросьте композит и CDN. Иначе на витрине останутся старые превью.
• Ресайзы. Битрикс генерирует уменьшенные копии на лету и кэширует их в /upload/resize_cache/. Эту папку тоже полезно очистить, чтобы пересобрались миниатюры.
• Права. Скрипты запускайте из-под пользователя с правами администратора модуля iblock, иначе Update вернёт ошибку прав.

Какой способ выбрать

Ориентируйтесь на источник изображений и регулярность задачи.

Разовую замену на паре сотен товаров проще сделать импортом CSV. Регулярное обновление ассортимента — только через обмен с 1С, иначе правки будут затираться. Сложные случаи с галереями и торговыми предложениями почти всегда упираются в скрипт на API.

Итог

Массовая замена картинок в каталоге Битрикс сводится к четырём проверенным путям: обмен с 1С, импорт CSV по ссылкам, скрипт-привязка по имени файла и прямое обновление через CFile с CIBlockElement::Update. Выбор зависит от того, где хранятся исходники и как часто их меняют. В любом случае обязательны бэкап, сброс кэша и очистка resize_cache, а также контроль совместимости с обменом 1С, чтобы правки не затирались.

Если каталог большой, картинок много, а часть завязана на торговые предложения, ручные эксперименты рискованны. Мы в B2Bsite настраиваем корректный обмен изображениями с 1С, пишем безопасные пакетные скрипты обновления и следим, чтобы витрина отдавала свежие фото без потери скорости. Обращайтесь — соберём процесс так, чтобы обновление фото стало рутиной на пару кликов.