Указатель по симптомам: найдите строку, похожую на то, что видит клиент, и переходите в статью с разбором. Ниже указателя — разбор двух случаев, которые встречаются чаще всего.

Сайт не открывается или выглядит сломанным

• Грузится только шапка, дальше пусто — разобрано ниже на этой странице.

• 502 Bad Gateway — 502 Bad Gateway.

• Пустой блок или ошибка 500 в ответе API — Как посмотреть детали 500 ошибки.

• Сломалось сразу после обновления — Решение типичных проблем.

• Не получается установить решение — Ошибки во время установки.

• Слетели настройки решения — Резервные копии настроек.

• Нужно поднять сайт из бэкапа — Восстановление сайта из резервной копии.

Каталог, фильтр и поиск

• Фильтр не показывает свойство или находит не все товары — Фильтр товаров, разделы про фасетный индекс.

• После прерванного обмена с 1С фильтр показывает неполные данные — там же, раздел про прерванный обмен.

• Поиск ничего не находит — Поиск.

• Сканер в приложении не находит товар — Поиск по штрихкоду.

• Блок с товарами пустой или показывает не то — FAQ блоков с товарами.

• На странице бренда нет товаров — Бренды.

• Товар не показывается как «в наличии» — Наличие.

Корзина и заказ

• Заказ не оформляется — Заказ не оформляется.

• Способ оплаты не показывается покупателю — Способы оплаты.

• Пропала служба доставки после включения групп — Группировка доставок.

• В карточке товара нет нужной службы доставки — Карточка товара.

• Дублируется поле «Адрес доставки» — Дублируется поле Адрес доставки.

• В корзине нет блока рекомендаций — Не показывается блок рекомендаций.

Письма и уведомления

• Письма с сайта не приходят — Уведомления.

• Нужного шаблона письма нет в списке — там же: свои письма решение создаёт при первой отправке.

• Push-уведомления не приходят или рассылка идёт долго — FAQ push-рассылок.

SEO

• Карта сайта не обновляется — Карта сайта.

Прежде чем искать причину

Три проверки закрывают половину обращений:

Фоновые задачи. Индекс фильтра, карта сайта, push-рассылки, лейблы со сроками, бонусы — всё это делает cron. Если он не настроен, эти вещи просто не происходят, без ошибок. Как проверить — в статье «cron».

Кеш. Изменили настройку и не видите результата — сбросьте кеш сайта и проверьте в приватном окне браузера, а не в той же вкладке.

Версия решения. Если проблема появилась после обновления или, наоборот, описанной настройки нет в админке, сверьте версию: Обновление решения.

Грузится только шапка

Если отображается только верхняя часть сайта (шапка/header), это означает, что произошли ошибки загрузки.

Чтобы увидеть причины откройте консоль разработчика. В Google Chrome используйте комбинацию клавиш Ctrl + Shift + I (Windows) или Cmd + Option + I (Mac).

Перейдите на вкладку Console для просмотра ошибок.

Mixed Content

Полный текст ошибки примерно следующий:

Причина:

Вы открыли сайт через HTTPS без корректного сертификата, что вызывает блокировку загрузки контента по HTTP. Это связано с политикой безопасности браузера.

Решение:

• Если в настройках указан адрес с HTTP, открывайте сайт через HTTP.

• Если указан адрес с HTTPS, используйте HTTPS и убедитесь, что установлен корректный сертификат.

Не отображаются картинки товаров

Если изображение товара отображается в административной панели, но не видно в публичной части сайта, возможной причиной может быть некорректное имя файла изображения: наличие пробелов и кириллических символов в названии.

Как проверить название файла

Зайдите в административную панель и откройте карточку любого товара.

Наведите курсор мыши на изображение товара. Появится всплывающее окно с параметрами изображения.

В этом окне найдите параметр Ссылка. Проверьте, содержатся ли в ссылке пробелы. Если да, то проблема именно в этом.

Почему это возникает?

По умолчанию система 1С-Битрикс преобразует имена файлов с пробелами и кириллическими буквами в латиницу и заменяет пробелы на нижнее подчёркивание. Однако иногда настройки могут быть выключены, что приводит к проблемам с отображением изображений.

Как исправить проблему?

Перейдите в Настройки → Настройки продукта → Настройки модулей → Главный модуль.

В разделе Файлы убедитесь, что включены следующие опции:

• Производить транслитерацию имени файла.

• Автоматически заменять невалидные символы в именах загружаемых файлов.

После активации этих настроек загрузите изображение повторно.

Если после выполнения всех шагов название файла по-прежнему сохраняется без изменений (например, остаются пробелы или кириллица), обратитесь в техническую поддержку 1С-Битрикс для дополнительной помощи.

Товар есть в админке, но его нет на сайте

Причина:

Товар не проходит одно из условий, по которым решение показывает его в каталоге.

Решение:

Проверьте по порядку:

• у товара заполнена базовая цена — точнее, цена того типа, который выбран в настройках: вкладка Каталог, блок Цены и валюта, поле Типы цен;

• товар в наличии или доступен под заказ;

• товар привязан к конкретному разделу, а не к верхнему уровню каталога;

• товар активен, и дата начала активности не в будущем.

Если всё заполнено, а товара по-прежнему нет, пересохраните его: это сбросит кеш каталога.

Раздел не показывается в меню каталога

Причина:

Меню каталога скрывает разделы, в которых покупателю нечего купить.

Решение:

Раздел появится в меню, только когда выполнены все условия:

• в разделе есть товары;

• у товаров заполнены цены;

• товары доступны к покупке — остаток больше нуля или разрешён заказ под заказ.

Если условия выполнены, а раздела нет, проверьте настройку Показывать разделы только с доступными товарами: вкладка Каталог, блок Списки товаров и разделы.

Нет панели редактирования «Эрмитаж»

Причина:

Публичная часть МаркетПро — это приложение на Nuxt, а не страницы на PHP. Панель «Эрмитаж» и режим правки прямо на сайте работают только на обычных сайтах 1С-Битрикс и в решении недоступны.

Решение:

Правка делается в админке: товары и разделы — в каталоге, тексты — в инфоблоках и текстовых страницах, внешний вид — в настройках решения. Это не временное ограничение, а следствие архитектуры: см. Архитектура решения.