JSON-LD
Определение
Формат записи структурированных данных Schema.org в JSON (рекомендация W3C, 2014). Используется как основной способ внедрения разметки на веб-страницы: отдельный блок в секции head или body, не зависит от вёрстки.
3 мин 204 Обновлено 14 мая
JSON-LD – основной формат структурированной разметки для сайтов в 2025–2026. Если на проекте делается SEO или GEO-оптимизация, разметка организации, авторов, статей, продуктов или услуг идёт через JSON-LD. Альтернативные форматы (Microdata, RDFa) остались для legacy-проектов.
Как это работает
JSON-LD – это блок кода в HTML-странице, который описывает сущности страницы (организация, автор статьи, продукт, услуга, событие) в формате JSON по словарю Schema.org. Поисковики и AI-сервисы парсят этот блок отдельно от визуального HTML и используют для построения knowledge graph.
Минимальный пример – разметка организации:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Клиника X",
"url": "https://klinika-x.ru/",
"telephone": "+7 495 ...",
"address": {
"@type": "PostalAddress",
"streetAddress": "Тверская, 10",
"addressLocality": "Москва",
"postalCode": "125009",
"addressCountry": "RU"
}
}
</script>Этот блок вставляется в <head> или <body> страницы. Браузер его игнорирует (тип application/ld+json – не исполняемый). Поисковики и AI его читают и добавляют сущность в свой индекс.
JSON-LD vs Microdata vs RDFa
Три способа разметить страницу по Schema.org:
- JSON-LD – отдельный JSON-блок, не зависит от вёрстки. Рекомендация Google с 2014. Самый популярный формат в 2025–2026
- Microdata – атрибуты
itemscope,itemtype,itempropпрямо в HTML-тегах. Старее, используется в legacy-проектах - RDFa – атрибуты
vocab,typeof,propertyв HTML-тегах. Чаще встречается в академических проектах и Drupal-сайтах
На один сайт можно использовать только один формат (либо смешивать осторожно). JSON-LD выигрывает за счёт того, что разметку можно поддерживать отдельно от вёрстки – программист не зависит от дизайнера, и обновление шаблонов не ломает SEO.
Зачем это нужно
- Knowledge Panel в Google. Карточка справа от выдачи (фото, контакты, отзывы) строится из Schema.org-разметки, чаще всего JSON-LD
- Rich snippets в поиске. FAQPage, HowTo, Product, Recipe Schema через JSON-LD могут помогать получить расширенное представление в выдаче, если тип поддерживается поисковиком и сайт соответствует требованиям. По состоянию на 2025 Google заметно ограничил показ FAQ rich results – они отображаются преимущественно для государственных и медицинских сайтов; HowTo rich results тоже сильно урезаны
- Entity-сборка для AI. Без JSON-LD AI-системы парсят только текст страницы, без структурированных данных. С JSON-LD у каждой сущности есть «карточка» с атрибутами, которую AI читает легче, чем неструктурированный текст
- NAP-консистентность. JSON-LD-разметка организации становится «source of truth» для NAP-данных. Если в шапке сайта телефон обновили, а в JSON-LD забыли – поисковик будет видеть JSON-LD-версию
Основные типы JSON-LD для бизнеса
Organization/LocalBusiness/MedicalOrganization– для самой компанииPerson– для авторов статей, врачей, экспертовArticle/BlogPosting– для статей и постовFAQPage– для страниц с вопросами и ответамиHowTo– для пошаговых инструкцийService/Product– для услуг и товаровBreadcrumbList– для хлебных крошекWebSite/SearchAction– для главной страницы + sitelinks-поиск
Как валидировать JSON-LD
- Schema.org Validator – официальный валидатор от консорциума Schema.org (https://validator.schema.org/)
- Google Rich Results Test – показывает, какие rich snippets получит страница (https://search.google.com/test/rich-results)
- Yandex Webmaster – структурированные данные – для проверки в индексе Яндекса (раздел «Структурированные данные» в Вебмастере)
- Расширения браузера – Structured Data Tester, JSON-LD viewer
Частые ошибки
1. Дублируется один и тот же Organization на каждой странице. Полная разметка организации нужна один раз на главной + в <head> лендингов, но не повторять её на странице каждой статьи. Достаточно ссылаться через mainEntityOfPage.
2. Разметка не соответствует видимому контенту. Google считает это «spammy structured data» и может санкционировать страницу. В JSON-LD-разметке статьи должны быть те же автор/дата/заголовок, что видны на странице.
3. Не обновляют JSON-LD при смене контактов. Обновили телефон в подвале сайта – а в JSON-LD старый. Поисковики и AI больше доверяют разметке, и обновлять её критично важно.
4. Используют устаревший контекст. "@context": "http://schema.org" устарел, нужно "https://schema.org" (с https). Старая разметка может игнорироваться.
5. Забывают про sameAs. Голая разметка Organization без sameAs-связок к Wikidata, соцсетям, картам – это половина возможной пользы. sameAs – почти бесплатная часть JSON-LD, которая удваивает entity-сборку.
Частые вопросы
JSON-LD или Microdata – что выбрать?
JSON-LD. Google официально рекомендует JSON-LD с 2014 года, в 2025–2026 это стандарт индустрии. Microdata встречается в legacy-проектах и иногда удобнее для шаблонов с готовой версткой, но новые проекты делают на JSON-LD. На один сайт лучше один формат – смешивать рискованно (поисковик может выбирать «более полную» версию и игнорировать другую).
Где размещать блок JSON-LD на странице?
Чаще всего в <head> страницы – там его сразу видит парсер. Можно в <body> (например, в конце страницы перед </body>) – поисковики обнаружат его и там. Главное – не дублировать один и тот же блок в обоих местах: это вызывает предупреждения в Google Rich Results Test.
Влияет ли JSON-LD на скорость сайта?
Минимально. Блок JSON-LD – обычный текст в HTML, не исполняется JavaScript-движком, не делает запросов. Размер блока разметки организации – 500–2000 байт, разметка статьи + FAQPage – 2–5 КБ. На сайтах с правильной разметкой страниц прирост размера HTML обычно меньше 5%.
Что делать, если CMS не поддерживает JSON-LD из коробки?
Для Битрикса, Tilda, Wordpress, MODX есть готовые модули и плагины. Для самописных сайтов разметка добавляется через шаблоны: один блок в общий header.php (общая разметка организации + WebSite), второй на детальных страницах (Article/Product/Service с динамическими данными). Если CMS совсем закрыта – JSON-LD можно вставлять через Google Tag Manager (Custom HTML Tag).
Какие свойства Schema.org обязательные?
У каждого типа Schema.org есть свой минимум. Для Organization – name, url, address (для LocalBusiness), telephone. Для Article – headline, author, datePublished, image. Полный список обязательных полей для Rich Results – на странице Google Search Central (search.google.com/search-console/about). Schema.org-валидатор показывает «obligatory» поля прямо в интерфейсе.
Связанные термины
Материалы по теме
Что почитать дальше по этой теме