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

Хорошая новость: микроразметка — это не плагин, не конструктор и не «настройка в панели». Это текстовый блок, который ты вставляешь в шапку страницы руками. На первую страницу уйдёт минут двадцать, на все остальные — пять минут, потому что делается один раз в шаблоне.
Плохая новость: половина примеров в интернете предлагает начать с типа, который Google больше не показывает. Начнём с этого.
Шаг 1. Выбери тип — и не бери FAQPage
Тип должен описывать то, что реально есть на странице. Три варианта закрывают почти всё:
- Article (или BlogPosting) — статья, пост, разбор.
- Organization — главная страница: кто ты, логотип, ссылки.
- Product или LocalBusiness — товар либо бизнес с адресом.
А FAQPage не бери, хотя примеров с ним больше всего. Google выключил показ FAQ-сниппетов в поиске 7 мая 2026 года, а в июне убрал по ним документацию. Разметка пройдёт валидатор и не даст ничего.
Шаг 2. Собери блок
Формат — JSON-LD: обычный JSON внутри отдельного тега скрипта. Вот рабочая заготовка для статьи, из документации Google:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Заголовок статьи",
"image": ["https://example.com/photos/16x9/photo.jpg"],
"datePublished": "2026-09-03T08:00:00+03:00",
"dateModified": "2026-09-03T08:00:00+03:00",
"author": [{
"@type": "Person",
"name": "Имя Автора",
"url": "https://example.com/about/"
}]
}
</script>
Три вещи, на которых спотыкаются:
@contextи@typeобязательны — без них это просто JSON, а не разметка.- Даты в формате ISO, с часовым поясом.
- Картинка — абсолютным адресом, начиная с
https://.
Шаг 3. Вставь блок в шапку страницы
Место — внутри тега head. Не в каждый HTML-файл руками: положи блок в общий шаблон страницы, а значения подставляй из данных статьи. Тогда новая страница получает разметку автоматически.
Важно: блок описывает эту страницу. Разметка статьи должна лежать на странице статьи, а не на главной.
Шаг 4. Проверь двумя инструментами, а не одним
Они делают разное, и оба нужны:
- validator.schema.org — проверяет синтаксис и словарь. Отвечает на вопрос «это вообще валидная разметка».
- search.google.com/test/rich-results — проверяет право на расширенный сниппет. Отвечает на вопрос «Google согласен показать карточку».
Разметка может быть валидной по первому и нерабочей по второму — например, если у типа не хватает обязательного поля. Проверяй в таком порядке.
Шаг 5. Сверь разметку с тем, что видно на странице
Это шаг, который пропускают, и единственный, за который бывает наказание.
Правило из руководства Google: «Не размечай контент, который не виден читателям страницы». Если в разметке стоит рейтинг 4,9, на странице должен быть рейтинг 4,9. Если стоит цена — цена должна быть в карточке.
За расхождение прилетают ручные меры, и формулировка в документации жёсткая: страница теряет право на показ в виде расширенного сниппета. То есть ты не просто не получишь звёзды — ты лишишься возможности их получить.
Пройдись по каждому полю блока и найди его глазами на странице. Не нашёл — удали поле.
Шаг 6. Выложи и следи в Search Console
После деплоя разметка не появится мгновенно: сначала робот должен переобойти страницу. Дальше в Google Search Console открывается отчёт по расширенным результатам — там видно, сколько страниц с этим типом Google увидел и где нашёл ошибки.
Что получится
В коде страницы — один невидимый блок. В поиске — вместо голой синей ссылки карточка с картинкой, датой и автором.
Только помни главное ограничение, оно записано в документации прямым текстом:
Google не гарантирует, что твоя микроразметка появится в результатах поиска, даже если страница размечена правильно.
Если разметка стоит и валидна, а карточки нет — это отдельный сюжет с тремя типовыми причинами: почему расширенный сниппет не показывается.
Если страницы генерятся кодом
Отдельный случай, на котором спотыкаются те, у кого сайт не из статических файлов.
Подставляй значения, а не пиши блок руками. Заголовок, дата и автор у тебя уже есть в данных статьи — оттуда их и бери. Иначе через месяц половина страниц будет с чужой датой.
Экранируй кавычки. Если в заголовке статьи есть кавычка, а ты вставляешь его в JSON строкой — блок сломается молча. Собирай объект и сериализуй его штатными средствами языка, а не склеивай строку.
Отдавай блок сразу в HTML. Google умеет выполнять JavaScript, но между «умеет» и «сделает это на твоей странице сегодня» есть зазор. Разметка, дорисованная скриптом уже в браузере, попадает в индекс позже и не всегда.
Как проверить: открой исходный код страницы (не панель разработчика, а именно исходник) и найди в нём свой блок поиском. Нет в исходнике — значит, его рисует скрипт.
И правило из руководства Google, которое стоит запомнить сразу: не создавай пустые страницы только ради того, чтобы держать на них разметку.
Сколько ждать появления карточки?
От нескольких дней до пары недель — сначала нужен переобход страницы. Если страница вообще не в индексе, разметка не поможет: сначала разберись с индексацией.
Можно ли разметить сразу несколько типов на одной странице?
Да. Например, Organization для сайта и Article для самой статьи. Каждый тип — своим блоком скрипта, это нормально.
Разметка замедлит сайт?
Нет. Это несколько строк текста в шапке, без запросов и без скриптов, которые что-то выполняют.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





